Condividi tramite

Codici di errore: Inserimento Computer Planetario Pro di Microsoft

Questo articolo elenca i codici di errore che possono verificarsi durante l'inserimento o l'eliminazione di dati geospaziali da un GeoCatalog di Microsoft Planetary Computer Pro. Usare questo riferimento per identificare la causa degli errori di inserimento e trovare i passaggi di risoluzione per ogni tipo di errore.

Gli errori di inserimento possono verificarsi durante varie fasi del processo di inserimento dei dati, tra cui l'autenticazione, la convalida, la trasformazione e le operazioni di archiviazione (aggiunta ed eliminazione). Nella tabella seguente vengono fornite informazioni dettagliate su ogni codice di errore, il relativo significato e i passaggi per risolvere il problema.

Tabella dei codici di errore:

Codice Spiegazione Risoluzione dei problemi
AssetTransformationError Il sistema non è riuscito a trasformare l'asset durante l'inserimento. • Verificare che i file di asset siano in un formato supportato
• Verificare che i file di asset non siano danneggiati
• Assicurarsi che gli URL degli asset siano accessibili dall'origine di inserimento
CogTransformationError Il processo di trasformazione GeoTIFF (COG) ottimizzato per il cloud non è riuscito. • Assicurarsi che i file di origine siano file GeoTIFF validi con informazioni di georeferenziazione appropriate
• Convalidare i file con gli strumenti GDAL prima dell'inserimento
CogTransformationTimeout Il processo di trasformazione COG ha superato il limite di tempo, in genere con file molto grandi. • Suddividere file di grandi dimensioni in riquadri più piccoli
• Convertire i file in formato COG prima dell'inserimento per ignorare la trasformazione
CanceledOperation L'operazione di inserimento è stata annullata o terminata manualmente. • Nessuna azione necessaria per gli annullamenti intenzionali
• Controllare i log di sistema per motivi di annullamento automatico
CollectionDoesNotExist L'ID raccolta STAC a cui si fa riferimento nella richiesta di inserimento non esiste. • Creare la raccolta prima di tentare di inserire elementi in esso
EmptyAsset Il file di asset a cui si fa riferimento nell'elemento STAC non ha contenuto o è di 0 byte. • Verificare che i file di asset esistano negli URL specificati
• Assicurarsi che i file di asset contengano dati validi
ErrorsInBatchOperation Uno o più elementi in un'operazione di inserimento in blocco non sono riusciti. • Controllare i dettagli dell'operazione per individuare errori specifici degli elementi
• Provare a inserire singolarmente gli elementi non riusciti per isolare i problemi
GenericHttpIngestionError Si è verificato un errore HTTP generale durante l'accesso alle risorse di inserimento. • Controllare la connettività di rete
• Verificare che tutti gli URL degli asset siano accessibili
• Esaminare i codici di stato HTTP nei log per problemi specifici
GenericIngestionError Si è verificato un errore non specificato durante il processo di acquisizione. • Controllare i messaggi di errore dettagliati e i log di sistema
• Contattare il supporto tecnico se il problema persiste
ImportFileValidationFailed La convalida del catalogo STAC o del file di raccolta non è riuscita. Risoluzione degli errori di convalida STAC
IngestionAuthenticationFailed GeoCatalog non è riuscito ad eseguire l'autenticazione nell'origine di inserimento. Risoluzione dei problemi di autorizzazione di accesso
IngestionResourceConnectionFailed Impossibile stabilire la connessione al contenitore di archiviazione. Risoluzione dei problemi di autorizzazione di accesso
IngestionResourceForbidden GeoCatalog non dispone delle autorizzazioni per accedere alla risorsa. Risoluzione dei problemi di autorizzazione di accesso
IngestionResourceTimeout La richiesta di accesso alla fonte di acquisizione ha superato il limite di tempo. • Ripetere l'operazione
• Controllare l'integrità dei servizi di Azure per individuare interruzioni
• Verificare la connettività di rete tra GeoCatalog e archiviazione
IngestionResourceUriNotFound L'URI dell'asset o del catalogo specificato non esiste. Risoluzione dei problemi di autorizzazione di accesso
InternalError Si è verificato un errore imprevisto all'interno del servizio GeoCatalog. • Ripetere l'operazione
• Se l'errore persiste, contattare il supporto tecnico con l'ID operazione e il timestamp
InternalIntermitentError Si è verificato un errore interno temporaneo. • Attendere alcuni minuti e ripetere l'operazione
• Questi errori vengono in genere risolti automaticamente
InvalidAssetHref L'URL dell'asset nell'elemento STAC è malformato o non valido. • Assicurarsi che tutti gli URL href degli asset siano formattati correttamente
• Usare URL assoluti, non percorsi relativi
• Verificare tutti gli URL che puntano alle risorse accessibili
InvalidGeoparquet Il file GeoParquet non soddisfa le specifiche di formato necessarie. • Convalidare i file GeoParquet usando gli strumenti appropriati
• Verifica che i file contengano colonne di geometria valide
InvalidInputData I dati di raccolta o dell'elemento STAC contengono campi o valori non validi. Risoluzione degli errori di convalida STAC
InvalidStacCatalog La struttura del catalogo STAC non è conforme alle specifiche. Risoluzione degli errori di convalida STAC
ItemAlreadyExistsInCollection Un elemento STAC con lo stesso ID esiste già nella raccolta. • Usare ID univoci per ogni elemento
• Eliminare l'elemento esistente prima di tentare nuovamente l'inserimento
ItemSizeExceeded Il codice JSON dell'elemento STAC supera le dimensioni massime consentite (1 MB). • Ridurre il numero di asset o proprietà nell'elemento
• Suddividere elementi di grandi dimensioni in più elementi più piccoli
ItemTransformationError Impossibile elaborare o trasformare l'elemento STAC. Risoluzione degli errori di convalida STAC
ManagedIdentityInfoNotFound L'identità gestita specificata non esiste o non è associata a GeoCatalog. Risoluzione dei problemi di autorizzazione di accesso
NoRecordsToDelete L'operazione di eliminazione non ha trovato record corrispondenti. • Verificare gli ID elemento STAC o i criteri di ricerca usati per l'eliminazione
• Verificare che gli elementi esistano nella raccolta specificata
NoRecordsToPatch L'operazione patch non ha trovato record corrispondenti. • Assicurarsi che gli elementi STAC che si sta tentando di aggiornare esistano nella raccolta
• Verificare che gli ID elemento siano corretti
NoRecordsToUpdate L'operazione di aggiornamento non ha trovato record corrispondenti. • Verificare che gli elementi esistano prima di tentare gli aggiornamenti
• Verificare l'accuratezza degli ID elemento e degli ID raccolta
OperationIsCanceled L'operazione di inserimento è stata annullata prima del completamento. • Controllare se l'annullamento è stato intenzionale
Esaminare i log di sistema per gli attivatori di annullamento automatico
OperationNotExistsInCollection L'ID operazione a cui si fa riferimento non esiste per questa raccolta. • Verificare di utilizzare l'ID operazione corretto e la raccolta corretta.
PatchValidation L'operazione patch contiene dati o operazioni non validi. • Assicurarsi che la patch segua le specifiche della patch JSON
• Verificare che le operazioni patch siano destinate a campi validi
PostItemCollectionSizeExceeded Il batch di elementi inviati supera il limite di dimensioni. • Ridurre il numero di elementi in una singola richiesta
• Usare l'API di inserimento bulk per set di dati di grandi dimensioni
PublicAccessRestricted La risorsa di archiviazione non consente l'accesso pubblico. Risoluzione dei problemi di autorizzazione di accesso
StacValidationFailed L'elemento STAC non soddisfa i requisiti di convalida. Risoluzione degli errori di convalida STAC
TotalAssetsExceeded L'elemento STAC contiene troppi asset (massimo 100 asset). • Ridurre il numero di asset per articolo al di sotto di 100
• Suddividere in più elementi

Contenuti correlati