Compartilhar via


Ingerir dados no Microsoft Planetry Computer Pro

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:

Diagrama que mostra a ingestão segura no Microsoft Planetary Computer Pro.

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.

Captura de tela do Portal do GeoCatalog mostrando onde o botão Configurações está localizado.

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.

Captura de tela da GUI de ingestã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.

Captura de tela da GUI de ingestão de item único.

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:

Próximas etapas

Saiba mais sobre como configurar uma fonte de ingestão: