Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Os recursos de ingestão do Microsoft Planetary Computer Pro permitem que os usuários tragam seus próprios dados para uma plataforma habilitada para nuvem eficaz na indexação, armazenamento e consulta de ativos geoespaciais em escala. Os dados ingeridos e armazenados em um GeoCatalog do Computador Planetário Pro usam o padrão aberto do SpatioTemporal Asset Catalog (STAC) para indexar, consultar e recuperar dados geoespaciais. Para obter mais informações sobre o STAC, consulte a visão geral do STAC.
Este diagrama fornece uma visão geral de como os vários elementos no serviço de ingestão funcionam juntos:
Pré-requisitos
Fontes de ingestão
As fontes de ingestão são representações dos mecanismos de localização e autenticação necessários para ingerir dados em um recurso do GeoCatalog. Os usuários podem listar e configurar fontes de ingestão na guia Configurações da interface da Web ou usando a API geocatalog. Depois que a fonte de ingestão for definida, os dados armazenados nesse local estarão disponíveis para ingestão segura em seu GeoCatalog.
Tipos de armazenamento com suporte
O Planetry Computer Pro dá suporte à ingestão de ativos geoespaciais das seguintes fontes de armazenamento:
- Armazenamento de Blobs do Azure com Identidade Gerenciada e Tokens SAS
- URLs públicas
- Buckets S3 com chaves assinadas
Aviso
Todos os dados ingeridos no Computador Planetário Pro exigem itens STAC.
Dica
Para acelerar a criação de itens stac, temos um tutorial detalhado e também temos uma ferramenta de software livre chamada STAC Forge.
Métodos de ingestão
Quando você fornece uma fonte de ingestão, como um contêiner de armazenamento de blobs ou URL pública, o Planetry Computer Pro pode acessar seus dados. Você pode ingerir coleções STAC, itens STAC e ativos armazenados no local especificado no Computador Planetário Pro. O recurso GeoCatalog deve ter acesso ao JSON da coleção STAC e aos ativos geoespaciais (imagens, dados etc.) que os itens STAC da coleção STAC apontam.
Durante o processo de ingestão, arquivos GEOTIFF, JPEG, JPEG2000, PNG e TIFF são transformados em COGs (GeoTIFFs otimizados para nuvem), mas os usuários também podem selecionar uma opção para copiar arquivos originais.
Observação
Os dados já no formato COG não são transformados.
A ingestão também dá suporte à otimização de nuvem para vários formatos de cubo de dados; confira Visão geral do cubo de dados Os usuários também podem selecionar ignorar determinados itens no catálogo.
Há dois métodos de ingestão disponíveis dependendo do caso de uso: ingestão em massa e ingestão de item único. Cada um pode ser feito por meio da interface da Web ou da API.
Ingestão em Massa
A ingestão em massa permite que os usuários ingeram automaticamente uma coleção STAC existente, incluindo seu arquivo JSON de coleção, Itens STAC associados e os ativos STAC subjacentes (imagens, dados etc.). A ingestão em massa move rapidamente esses artefatos para um GeoCatalog especificando a fonte de dados (por exemplo, Armazenamento de Blobs), a URL de conexão e o tipo de item. A Ingestão em Massa usa essas entradas e parâmetros para executar um fluxo de trabalho de ingestão. Para mais informações sobre a inserção de dados em massa, confira Inserir dados no GeoCatalog com a API de Inserção em Massa.
Ingestão de Item Único
Considerando uma coleção STAC pré-existente em um GeoCatalog, os usuários podem ingerir novos ou atualizar itens STAC existentes e seus ativos associados usando a interface web do Planetry Computer Pro ou a API. Em contraste com o recurso ingestão em massa do Computador Planetário Pro, a ingestão de Item Único destina-se a importações ou atualizações de baixa latência versus migrações de dados grandes. Para obter mais informações sobre a ingestão em massa, consulte Adicionar itens STAC a uma coleção.
Solução de problemas de ingestão
Se você encontrar problemas durante a ingestão de dados, como falhas de autenticação, erros de validação stac ou problemas com a transformação de ativos, consulte nossa documentação dedicada de solução de problemas:
- Solução de problemas de ingestão de dados no Microsoft Planetary Computer Pro: este guia ajuda você a identificar e resolver falhas comuns de ingestão, incluindo problemas de permissão de acesso e erros de validação stac.
- Códigos de erro: ingestão do Microsoft Planetary Computer Pro: essa referência lista códigos de erro específicos que você pode encontrar durante a ingestão, juntamente com seus significados e etapas de resolução.
Próximas etapas
Saiba mais sobre como configurar uma fonte de ingestão:
Conteúdo relacionado
- Configurar uma fonte de ingestão para o Microsoft Planetary Computer Pro usando a identidade gerenciada
- Adicionar itens STAC a uma coleção com GeoCatalog e Python
- Ingerir dados no GeoCatalog com a API de ingestão em massa
- Solução de problemas de ingestão de dados
- Códigos de erro: ingestão do Computador Planetário Pro da Microsoft