Kody błędów: Przetwarzanie danych Microsoft Planetary Computer Pro

W tym artykule wymieniono kody błędów, które mogą wystąpić podczas pozyskiwania lub usuwania danych geoprzestrzennych z komputera planetarnego Microsoft Pro GeoCatalog. Użyj tego odwołania, aby zidentyfikować przyczynę niepowodzeń pozyskiwania i znaleźć kroki rozwiązywania dla każdego typu błędu.

Błędy przetwarzania mogą wystąpić na różnych etapach procesu importu danych, takich jak uwierzytelnianie, walidacja, transformacja oraz operacje przechowywania (dodawanie i usuwanie). Poniższa tabela zawiera szczegółowe informacje o każdym kodzie błędu, jego znaczeniu i krokach w celu rozwiązania problemu.

Tabela kodów błędów:

Code Wyjaśnienie Rozwiązywanie problemów
AssetTransformationError System nie zdołał przekształcić zasobu podczas pozyskiwania. • Sprawdź, czy pliki elementów zawartości są w obsługiwanym formacie
• Sprawdź, czy pliki zasobów nie są uszkodzone
• Upewnij się, że adresy URL zasobów są dostępne ze źródła pozyskiwania
CogTransformationError Proces przekształcania GeoTIFF (COG) zoptymalizowany pod kątem chmury nie powiodł się. • Upewnij się, że pliki źródłowe są prawidłowymi plikami GeoTIFF z odpowiednimi informacjami dotyczącymi wnioskowania geograficznego
• Zweryfikuj swoje pliki za pomocą narzędzi GDAL przed ich wczytaniem.
CogTransformationTimeout Proces przekształcania COG przekroczył limit czasu, co zazwyczaj dzieje się przy bardzo dużych plikach. • Podziel duże pliki na mniejsze kafelki
• Konwertuj pliki na format COG przed importem w celu pominięcia transformacji
CanceledOperation Operacja pozyskiwania została ręcznie anulowana lub zakończona. • Brak akcji wymaganej do zamierzonego anulowania
• Sprawdź dzienniki systemowe w poszukiwaniu powodów automatycznego anulowania
CollectionDoesNotExist Identyfikator kolekcji STAC wskazany w twoim żądaniu importu nie istnieje. • Utwórz kolekcję przed podjęciem próby pozyskiwania do niej elementów
EmptyAsset Plik zasobu, do którego odwołuje się element STAC, nie ma zawartości lub jest pusty (0 bajtów). • Sprawdź, czy pliki elementów zawartości istnieją pod określonymi adresami URL
• Upewnij się, że pliki zasobów zawierają prawidłowe dane
ErrorsInBatchOperation Jeden lub więcej elementów operacji pozyskiwania zbiorczego zakończyło się niepowodzeniem. • Sprawdzanie szczegółów operacji pod kątem konkretnych niepowodzeń elementów
• Spróbuj przetestować nieudane elementy pojedynczo, aby wyizolować problemy
GenericHttpIngestionError Wystąpił ogólny błąd HTTP podczas uzyskiwania dostępu do zasobów importu danych. • Sprawdzanie łączności sieciowej
• Sprawdź, czy wszystkie adresy URL zasobów są dostępne
• Przejrzyj kody stanu HTTP w dziennikach pod kątem konkretnych problemów
GenericIngestionError Podczas pozyskiwania wystąpił nieokreślony błąd. • Sprawdzanie szczegółowych komunikatów o błędach i dzienników systemowych
• Skontaktuj się z pomocą techniczną, jeśli problem będzie się powtarzać
ImportFileValidationFailed Walidacja katalogu STAC lub pliku kolekcji nie powiodła się. Rozwiązywanie problemów z błędami walidacji STAC
IngestionAuthenticationFailed Usługa GeoCatalog nie może uwierzytelnić się w źródle pozyskiwania. Rozwiązywanie problemów z uprawnieniami dostępu
IngestionResourceConnectionFailed Nie można nawiązać połączenia z kontenerem magazynu. Rozwiązywanie problemów z uprawnieniami dostępu
IngestionResourceForbidden W dzienniku geograficznym brakuje uprawnień dostępu do zasobu. Rozwiązywanie problemów z uprawnieniami dostępu
IngestionResourceTimeout Żądanie dostępu do źródła pozyskiwania przekroczyło limit czasu. • Ponów próbę wykonania operacji
• Sprawdzanie kondycji usługi platformy Azure pod kątem awarii
• Weryfikowanie łączności sieciowej między serwerem GeoCatalog i magazynem
IngestionResourceUriNotFound Określony identyfikator URI zasobu lub wykazu nie istnieje. Rozwiązywanie problemów z uprawnieniami dostępu
InternalError Wystąpił nieoczekiwany błąd w usłudze GeoCatalog. • Ponów próbę wykonania operacji
• Jeśli błąd będzie się powtarzać, skontaktuj się z pomocą techniczną przy użyciu identyfikatora operacji i znacznika czasu
InternalIntermitentError Wystąpił tymczasowy błąd wewnętrzny. • Poczekaj kilka minut i spróbuj ponownie wykonać operację
• Te błędy zwykle są automatycznie rozwiązywane
InvalidAssetHref Adres URL zasobu w elemencie STAC jest źle sformułowany lub nieprawidłowy. • Upewnij się, że wszystkie odnośniki zasobów są poprawnie sformatowanymi adresami URL
• Użyj bezwzględnych adresów URL, a nie ścieżek względnych
• Sprawdź, czy wszystkie adresy URL wskazują dostępne zasoby
InvalidGeoparquet Plik GeoParquet nie spełnia wymaganych specyfikacji formatu. • Weryfikowanie plików GeoParquet przy użyciu odpowiednich narzędzi
• Upewnij się, że pliki zawierają prawidłowe kolumny geometryczne
InvalidInputData Element STAC lub dane kolekcji zawierają nieprawidłowe pola lub wartości. Rozwiązywanie problemów z błędami walidacji STAC
InvalidStacCatalog Struktura wykazu STAC nie jest zgodna ze specyfikacjami. Rozwiązywanie problemów z błędami walidacji STAC
ItemAlreadyExistsInCollection Element STAC o tym samym identyfikatorze już istnieje w kolekcji. • Używanie unikatowych identyfikatorów dla każdego elementu
Usuń istniejący element, przed ponowną próbą wczytania.
ItemSizeExceeded Kod JSON elementu STAC przekracza maksymalny dozwolony rozmiar (1 MB). • Zmniejszenie liczby zasobów lub właściwości w elemencie
• Podziel duże elementy na wiele mniejszych elementów
ItemTransformationError Nie można przetworzyć lub przekształcić elementu STAC. Rozwiązywanie problemów z błędami walidacji STAC
ManagedIdentityInfoNotFound Określona tożsamość zarządzana nie istnieje lub nie jest skojarzona z GeoKatalogiem. Rozwiązywanie problemów z uprawnieniami dostępu
NoRecordsToDelete Operacja usuwania nie znalazła żadnych pasujących rekordów. • Sprawdź identyfikatory elementów STAC lub kryteria wyszukiwania używane do usunięcia
• Potwierdzanie istnienia elementów w określonej kolekcji
NoRecordsToPatch Operacja stosowania poprawek nie znalazła żadnych pasujących rekordów. • Upewnij się, że w kolekcji istnieją elementy STAC, które próbujesz zaktualizować
• Sprawdź, czy identyfikatory elementów są poprawne
NoRecordsToUpdate Operacja aktualizacji nie znalazła żadnych pasujących rekordów. • Przed podjęciem próby aktualizacji sprawdź, czy elementy istnieją
• Sprawdzanie identyfikatorów elementów i identyfikatorów kolekcji pod kątem dokładności
OperationIsCanceled Operacja pozyskiwania została anulowana przed zakończeniem. • Sprawdzanie, czy anulowanie było zamierzone
• Przeglądanie dzienników systemowych pod kątem wyzwalaczy automatycznego anulowania
OperationNotExistsInCollection Podany identyfikator operacji nie istnieje w tej kolekcji. • Sprawdź, czy używasz poprawnego identyfikatora operacji i kolekcji
PatchValidation Operacja stosowania poprawek zawiera nieprawidłowe dane lub operacje. • Upewnij się, że poprawka jest zgodna ze specyfikacjami poprawek JSON
• Sprawdzanie, czy operacje poprawek dotyczą prawidłowych pól
PostItemCollectionSizeExceeded Partia publikowanych elementów przekracza limit rozmiaru. • Zmniejszenie liczby elementów w jednym żądaniu
• Użyj API do masowego pobierania dla dużych zestawów danych
PublicAccessRestricted Zasób magazynu nie zezwala na dostęp publiczny. Rozwiązywanie problemów z uprawnieniami dostępu
StacValidationFailed Element STAC nie spełnia wymagań dotyczących walidacji. Rozwiązywanie problemów z błędami walidacji STAC
TotalAssetsExceeded Element STAC zawiera zbyt wiele zasobów (maksymalnie 100 zasobów). • Zmniejsz liczbę zasobów na element do poniżej 100
• Podziel na wiele elementów