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.
Este artigo lista os códigos de erro que podem ocorrer ao ingerir ou excluir dados geoespaciais de um Microsoft Planetary Computer Pro GeoCatalog. Use esta referência para identificar a causa das falhas de ingestão e encontrar etapas de resolução para cada tipo de erro.
Os 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:
| Código | Explicação | Solução de problemas |
|---|---|---|
AssetTransformationError |
O sistema não conseguiu transformar o ativo durante a ingestão. | • Verifique se os arquivos de ativos estão em um formato suportado • Verifique se os arquivos de ativos não estão corrompidos • Certifique-se de que os URLs dos ativos estão acessíveis a partir da sua fonte de ingestão |
CogTransformationError |
O processo de transformação Cloud Optimized GeoTIFF (COG) falhou. | • Certifique-se de que os arquivos de origem são arquivos GeoTIFF válidos com informações de georreferenciamento adequadas • Valide os seus ficheiros com ferramentas GDAL antes da ingestão |
CogTransformationTimeout |
O processo de transformação COG excedeu o limite de tempo, normalmente com arquivos muito grandes. | • Divida arquivos grandes em blocos menores • Converta arquivos para o formato COG antes da ingestão para pular a transformação |
CanceledOperation |
A operação de ingestão foi manualmente cancelada ou encerrada. | • Nenhuma ação necessária para cancelamentos intencionais • Verifique os logs do sistema por motivos de cancelamento automático |
CollectionDoesNotExist |
O ID de coleção STAC referenciado na sua solicitação de ingestão não existe. | • Crie a coleção antes de tentar ingerir itens nela |
EmptyAsset |
O arquivo de ativo referenciado no item STAC não tem conteúdo ou é de 0 bytes. | • Verifique se os arquivos de ativos existem nos URLs especificados • Certifique-se de que os arquivos de ativos contenham dados válidos |
ErrorsInBatchOperation |
Um ou mais itens numa operação de ingestão em massa falharam. | • Verifique 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. | • Verifique a conectividade de rede • Verifique se todos os URLs de ativos estão acessíveis • Revisar códigos de status HTTP em logs para problemas específicos |
GenericIngestionError |
Ocorreu um erro não especificado durante a ingestão. | • Verifique mensagens de erro detalhadas e logs do sistema • Entre em contato com o suporte se o problema persistir |
ImportFileValidationFailed |
O catálogo ou arquivo de coleção STAC falhou na validação. | Solução de problemas de erros de validação 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 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 |
O pedido de acesso à fonte de ingestão excedeu o limite de tempo. | • Repetir a operação • Verifique 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 do ativo ou catálogo especificado não existe. | Solução de problemas de permissão de acesso |
InternalError |
Ocorreu um erro inesperado no serviço GeoCatalog. | • Repetir a operação • Se o erro persistir, entre em contato com o suporte com o ID da operação e carimbo de data/hora |
InternalIntermitentError |
Ocorreu um erro interno temporário. | • Aguarde alguns minutos e tente novamente a operação • Estes erros normalmente são resolvidos automaticamente |
InvalidAssetHref |
A URL do ativo no item STAC está malformada ou é inválida. | • Certifique-se de que todas as referências de hipertexto dos elementos estão formatadas como URLs corretamente • Use URLs absolutos, não caminhos relativos • Verifique se todos os URLs apontam para recursos acessíveis |
InvalidGeoparquet |
O arquivo GeoParquet não atende às especificações de formato exigidas. | • Validar arquivos GeoParquet usando ferramentas apropriadas • Certifique-se de que os ficheiros contêm colunas de geometria válidas |
InvalidInputData |
O item STAC ou os dados da coleção contêm campos ou valores inválidos. | Solução de problemas de erros de validação 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 STAC |
ItemAlreadyExistsInCollection |
Já existe um item STAC com o mesmo ID na coleção. | • Use identificadores exclusivos para cada item • Exclua o item existente antes de tentar ingerir novamente |
ItemSizeExceeded |
O item STAC JSON excede o tamanho máximo permitido (1 MB). | • Reduzir o número de ativos ou propriedades no item • Divida 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 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. | • Verificar os IDs de itens STAC ou os critérios de pesquisa usados para exclusão • Confirmar a existência de itens na coleção especificada |
NoRecordsToPatch |
A operação de patch não encontrou nenhum registro correspondente. | • Certifique-se de que os itens STAC que você está tentando atualizar existem na coleção • Verifique se os IDs dos itens estão corretos |
NoRecordsToUpdate |
A operação de atualização não encontrou nenhum registro correspondente. | • Verifique se os itens existem antes de tentar atualizações • Verifique a precisão dos IDs dos itens e dos IDs de coleção |
OperationIsCanceled |
A operação de ingestão foi cancelada antes da conclusão. | • Verifique se o cancelamento foi intencional • Verificar os logs do sistema para fatores desencadeantes de cancelações automáticas |
OperationNotExistsInCollection |
O ID da operação referenciada não existe para esta coleção. | • Verifique se você está usando o ID da operação e a coleta corretos |
PatchValidation |
A operação de patch contém dados ou operações inválidas. | • Certifique-se de que o seu patch segue as especificações do JSON Patch • Verificar se as operações de patch visam campos válidos |
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 • Use 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 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 |