Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. 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 Planetary Computer Pro GeoCatalog usam o padrão aberto SpatioTemporal Asset Catalog (STAC) para indexar, consultar e recuperar dados geoespaciais. Para obter mais informações sobre STAC, consulte 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 da localização e dos mecanismos de 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 do GeoCatalog. Uma vez definida a fonte de ingestão, os dados armazenados nesse local ficam disponíveis para ingestão segura no seu GeoCatalog.
Tipos de armazenamento suportados
O Planetary Computer Pro suporta a ingestão de ativos geoespaciais das seguintes fontes de armazenamento:
- Armazenamento de Blobs do Azure com Identidade Gerenciada e Tokens SAS
- URLs públicas
- Baldes S3 com chaves assinadas
Advertência
Todos os dados ingeridos no Planetary Computer Pro requerem STAC Itens.
Sugestão
Para acelerar a criação de itens STAC, temos um tutorial detalhado e também temos uma ferramenta de código aberto chamada STAC Forge.
Métodos de ingestão
Quando você fornece uma fonte de ingestão, como um contêiner de armazenamento de blob ou URL pública, o Planetary Computer Pro pode acessar seus dados. Você pode ingerir coleções STAC, itens STAC e ativos armazenados no local especificado no Planetary Computer Pro. O recurso GeoCatalog deve ter acesso à coleção STAC JSON e aos ativos geoespaciais (imagens, dados, etc.) para os quais os itens STAC da coleção STAC apontam.
Durante o processo de ingestão, os arquivos GEOTIFF, JPEG, JPEG2000, PNG e TIFF são transformados em COGs (Cloud Optimized GeoTIFFs), 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 Ingestion também suporta otimização de nuvem para vários formatos de cubo de dados; consulte Visão geral do cubo de dados Os usuários também podem optar por ignorar determinados itens no catálogo.
Existem dois métodos de ingestão disponíveis, dependendo do caso de uso: ingestão em massa e ingestão de um único item. Cada um pode ser feito através da interface web ou da API.
Ingestão a granel
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 ao especificar a fonte de dados (por exemplo, Blob Storage), a URL de conexão e o tipo de item. A ingestão em massa utiliza estas entradas e parâmetros para executar um processo de ingestão. Para mais informações sobre ingestão em massa, veja Ingestão de dados no GeoCatalog com a API de Ingestão Massiva.
Ingestão de um único item
Dada uma coleção STAC preexistente dentro de um GeoCatalog, os usuários podem ingerir itens STAC novos ou atualizar itens STAC existentes e seus ativos associados usando a interface da Web do Planetary Computer Pro ou a API. Em contraste com o recurso de ingestão em massa do Planetary Computer Pro, a ingestão de item único destina-se a importações ou atualizações de baixa latência versus grandes migrações de dados. Para obter mais informações sobre 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 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: Esta 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óximos passos
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 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 Microsoft Planetary Computer Pro