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.
Este artigo lista os códigos de erro que podem ocorrer ao ingerir ou excluir dados geoespaciais de um GeoCatalog do Microsoft Planetry Computer Pro. Use essa referência para identificar a causa das falhas de ingestão e encontrar etapas de resolução para cada tipo de erro.
Erros de ingestão podem ocorrer durante vários estágios do processo de ingestão de dados, incluindo operações de autenticação, validação, transformação e armazenamento (adição e exclusão). A tabela a seguir fornece informações detalhadas sobre cada código de erro, seu significado e etapas para resolver o problema.
Tabela de códigos de erro:
| Code | Explicação | Resolução de problemas |
|---|---|---|
AssetTransformationError |
O sistema falhou ao transformar o ativo durante a ingestão. | • Verificar se os arquivos de ativos estão em um formato compatível • Verifique se os arquivos de ativos não estão corrompidos • Verifique se as URLs do ativo estão acessíveis por meio da fonte de ingestão |
CogTransformationError |
O processo de transformação COG (Cloud Optimized GeoTIFF) falhou. | • Verifique se os arquivos de origem são arquivos GeoTIFF válidos com informações de georeferenciamento adequadas • Validar seus arquivos com ferramentas GDAL antes da ingestão |
CogTransformationTimeout |
O processo de transformação COG excedeu o limite de tempo, normalmente com arquivos muito grandes. | • Dividir arquivos grandes em blocos menores • Converter arquivos no formato COG antes da ingestão para ignorar a transformação |
CanceledOperation |
A operação de ingestão foi cancelada ou encerrada manualmente. | • Nenhuma ação necessária para cancelamentos intencionais • Verifique os logs do sistema por motivos de cancelamento automático |
CollectionDoesNotExist |
A ID da coleção STAC referenciada em sua solicitação de ingestão não existe. | • Criar a coleção antes de tentar ingerir itens nela |
EmptyAsset |
O arquivo de ativo referenciado no item STAC não tem conteúdo ou é 0 bytes. | • Verificar se os arquivos de ativo existem nas URLs especificadas • Verifique se os arquivos de recursos contêm dados válidos |
ErrorsInBatchOperation |
Falha em um ou mais itens em uma operação de ingestão em massa. | • Verificar os detalhes da operação para falhas de itens específicos • Tente ingerir itens com falha individualmente para isolar problemas |
GenericHttpIngestionError |
Ocorreu um erro HTTP geral ao acessar recursos de ingestão. | • Verificar a conectividade de rede • Verifique se todas as URLs dos ativos estão acessíveis • Examine os códigos de status HTTP nos logs em busca de problemas específicos |
GenericIngestionError |
Erro não especificado durante a ingestão. | • Verificar mensagens de erro detalhadas e logs do sistema • Se o problema persistir, entre em contato com o suporte. |
ImportFileValidationFailed |
Falha na validação do catálogo ou do arquivo de coleção STAC. | Solução de problemas de erros de validação do STAC |
IngestionAuthenticationFailed |
O GeoCatalog não pôde se autenticar na fonte de ingestão. | Solução de problemas de permissão de acesso |
IngestionResourceConnectionFailed |
Não é possível estabelecer a conexão com o contêiner de armazenamento. | Solução de problemas de permissão de acesso |
IngestionResourceForbidden |
O GeoCatalog não tem permissões para acessar o recurso. | Solução de problemas de permissão de acesso |
IngestionResourceTimeout |
A solicitação para acessar a fonte de ingestão excedeu o limite de tempo. | • Repita a operação • Verificar a integridade do serviço do Azure em busca de interrupções • Verificar a conectividade de rede entre o GeoCatalog e o armazenamento |
IngestionResourceUriNotFound |
O URI de catálogo ou ativo especificado não existe. | Solução de problemas de permissão de acesso |
InternalError |
Ocorreu um erro inesperado no serviço GeoCatalog. | • Repita a operação • Se o erro persistir, entre em contato com o suporte com a ID da operação e o carimbo de data/hora |
InternalIntermitentError |
Ocorreu um erro interno temporário. | • Aguarde alguns minutos e repita a operação • Esses erros normalmente são resolvidos automaticamente |
InvalidAssetHref |
A URL do ativo no item STAC é malformada ou inválida. | • Verifique se todos os hrefs dos recursos são URLs formatadas corretamente • Usar URLs absolutas, não caminhos relativos • Verificar se todas as URLs apontam para recursos acessíveis |
InvalidGeoparquet |
O arquivo GeoParquet não atende às especificações de formato necessárias. | • Validar arquivos GeoParquet usando ferramentas apropriadas • Verifique se os arquivos contêm colunas de geometria válidas |
InvalidInputData |
O item STAC ou os dados de coleção contêm valores ou campos inválidos. | Solução de problemas de erros de validação do STAC |
InvalidStacCatalog |
A estrutura do catálogo stac não está em conformidade com as especificações. | Solução de problemas de erros de validação do STAC |
ItemAlreadyExistsInCollection |
Já existe um item STAC com a mesma ID na coleção. | • Usar IDs exclusivas para cada item • Excluir o item existente antes de tentar ingerir novamente |
ItemSizeExceeded |
O JSON do item STAC excede o tamanho máximo permitido (1 MB). | • Reduzir o número de ativos ou propriedades no item • Dividir itens grandes em vários itens menores |
ItemTransformationError |
Falha ao processar ou transformar o item STAC. | Solução de problemas de erros de validação do STAC |
ManagedIdentityInfoNotFound |
A identidade gerenciada especificada não existe ou não está associada ao GeoCatalog. | Solução de problemas de permissão de acesso |
NoRecordsToDelete |
A operação de exclusão não encontrou nenhum registro correspondente. | • Verifique as IDs de item do STAC ou os critérios de pesquisa usados para exclusão • Confirmar se existem itens na coleção especificada |
NoRecordsToPatch |
A operação de patch não encontrou nenhum registro correspondente. | • Verifique se os itens STAC que você está tentando atualizar existem na coleção • Verifique se as IDs do item estão corretas |
NoRecordsToUpdate |
A operação de atualização não encontrou nenhum registro correspondente. | • Verifique se os itens existem antes de tentar atualizações • Verificar IDs de item e IDs de coleção para obter precisão |
OperationIsCanceled |
A operação de ingestão foi cancelada antes da conclusão. | • Verifique se o cancelamento foi intencional • Revisar os logs do sistema em busca de gatilhos de cancelamento automático |
OperationNotExistsInCollection |
A ID da operação referenciada não existe para essa coleção. | • Verifique se você está usando a ID e a coleção de operações corretas |
PatchValidation |
A operação de patch contém dados ou operações inválidas. | • Verifique se o patch segue as especificações de patch JSON • Verificar os campos válidos de destino das operações de patch |
PostItemCollectionSizeExceeded |
O lote de itens que estão sendo postados excede o limite de tamanho. | • Reduzir o número de itens em uma única solicitação • Usar a API de ingestão em massa para grandes conjuntos de dados |
PublicAccessRestricted |
O recurso de armazenamento não permite acesso público. | Solução de problemas de permissão de acesso |
StacValidationFailed |
O item STAC não atende aos requisitos de validação. | Solução de problemas de erros de validação do STAC |
TotalAssetsExceeded |
O item STAC contém muitos ativos (máximo de 100 ativos). | • Reduzir o número de ativos por item para menos de 100 • Dividir em vários itens |