この記事では、Microsoft プラネタリー コンピューター Pro GeoCatalog から地理空間データを取り込んだり削除したりするときに発生する可能性があるエラー コードを示します。 この参照を使用して、インジェスト エラーの原因を特定し、エラーの種類ごとに解決手順を見つけます。
インジェスト エラーは、認証、検証、変換、ストレージ操作 (追加と削除) など、データ インジェスト プロセスのさまざまな段階で発生する可能性があります。 次の表は、各エラー コード、その意味、および問題を解決するための手順に関する詳細情報を示しています。
エラー コードの表:
| Code | 説明 | トラブルシューティング |
|---|---|---|
AssetTransformationError |
システムはインジェスト中にアセットを変換できませんでした。 | • アセット ファイルがサポートされている形式であることを確認する • 資産ファイルが破損していないことを確認する • インジェスト ソースから資産 URL にアクセスできることを確認する |
CogTransformationError |
クラウド最適化 GeoTIFF (COG) 変換プロセスに失敗しました。 | • ソース ファイルが適切なジオリファレンス情報を持つ有効な GeoTIFF ファイルであることを確認する • インジェスト前に GDAL ツールを使用してファイルを検証する |
CogTransformationTimeout |
COG 変換プロセスは、通常は非常に大きなファイルで制限時間を超えました。 | •小さなタイルに大きなファイルを分割 • インジェスト前にファイルを COG 形式に変換して変換をスキップする |
CanceledOperation |
インジェスト操作が手動で取り消されたか、終了されました。 | • 意図的なキャンセルには何も必要ありません • 自動キャンセルの理由でシステム ログを確認する |
CollectionDoesNotExist |
インジェスト要求で参照されている STAC コレクション ID が存在しません。 | • コレクションにアイテムを 取り込もうとする前にコレクションを作成する |
EmptyAsset |
STAC 項目で参照される資産ファイルにコンテンツがないか、0 バイトです。 | • 指定した URL にアセット ファイルが存在するかどうかを確認する • 資産ファイルに有効なデータが含まれていることを確認する |
ErrorsInBatchOperation |
一括インジェスト操作の 1 つ以上の項目が失敗しました。 | • 操作の詳細で特定の項目のエラーを確認する • 問題を切り分けるために、失敗したアイテムを個別にインジェストしてみてください |
GenericHttpIngestionError |
インジェスト リソースへのアクセス中に一般的な HTTP エラーが発生しました。 | • ネットワーク接続を確認する • すべてのアセット URL にアクセス可能であることを確認する • ログの HTTP 状態コードで特定の問題を確認する |
GenericIngestionError |
インジェスト中に未指定のエラーが発生しました。 | • 詳細なエラーメッセージとシステムログを確認する • 問題が解決しない場合は、サポートにお問い合わせください |
ImportFileValidationFailed |
STAC カタログまたはコレクション ファイルの検証に失敗しました。 | STAC 検証エラーのトラブルシューティング |
IngestionAuthenticationFailed |
GeoCatalog がインジェスト ソースに対して認証できませんでした。 | アクセス許可に関する問題のトラブルシューティング |
IngestionResourceConnectionFailed |
ストレージ コンテナーへの接続を確立できません。 | アクセス許可に関する問題のトラブルシューティング |
IngestionResourceForbidden |
GeoCatalog には、リソースにアクセスするためのアクセス許可がありません。 | アクセス許可に関する問題のトラブルシューティング |
IngestionResourceTimeout |
インジェスト ソースへのアクセス要求が制限時間を超えました。 | • 操作を再試行する • Azure サービスの障害を確認する • GeoCatalog とストレージの間のネットワーク接続を確認する |
IngestionResourceUriNotFound |
指定された資産またはカタログ URI が存在しません。 | アクセス許可に関する問題のトラブルシューティング |
InternalError |
GeoCatalog サービス内で予期しないエラーが発生しました。 | • 操作を再試行する • エラーが解決しない場合は、操作 ID とタイムスタンプをサポートにお問い合わせください |
InternalIntermitentError |
一時的な内部エラーが発生しました。 | • 数分待ってから操作を再試行します • 通常、これらのエラーは自動的に解決されます。 |
InvalidAssetHref |
STAC 項目の資産 URL の形式が正しくないか、無効です。 | • すべてのアセットの href が適切に書式設定された URL であることを確認する • 相対パスではなく絶対 URL を使用する • すべての URL がアクセス可能なリソースをポイントすることを確認する |
InvalidGeoparquet |
GeoParquet ファイルは、必要な形式の仕様を満たしていません。 | • 適切なツールを使用して GeoParquet ファイルを検証する • ファイルに有効なジオメトリ列が含まれていることを確認する |
InvalidInputData |
STAC 項目またはコレクション・データに無効なフィールドまたは値が含まれています。 | STAC 検証エラーのトラブルシューティング |
InvalidStacCatalog |
STAC カタログ構造が仕様に準拠していません。 | STAC 検証エラーのトラブルシューティング |
ItemAlreadyExistsInCollection |
同じ ID の STAC 項目がコレクションに既に存在します。 | • アイテムごとに一意の ID を使用する • もう一度取り込もうとする前に既存の項目を削除する |
ItemSizeExceeded |
STAC 項目 JSON が最大許容サイズ (1 MB) を超えています。 | • アイテム内のアセットまたはプロパティの数を減らす • 大きなアイテムを複数の小さなアイテムに分割する |
ItemTransformationError |
STAC 項目を処理または変換できませんでした。 | STAC 検証エラーのトラブルシューティング |
ManagedIdentityInfoNotFound |
指定したマネージド ID が存在しないか、GeoCatalog に関連付けられていない。 | アクセス許可に関する問題のトラブルシューティング |
NoRecordsToDelete |
削除操作で、一致するレコードが見つかりませんでした。 | • 削除に使用する STAC 項目 ID または検索条件を確認する • 指定したコレクションにアイテムが存在するかどうかを確認する |
NoRecordsToPatch |
修正プログラムの操作で、一致するレコードが見つかりませんでした。 | • 更新しようとしている STAC 項目がコレクション内に存在することを確認する • アイテム ID が正しいことを確認する |
NoRecordsToUpdate |
更新操作で一致するレコードが見つかりませんでした。 | • 更新を試みる前に項目が存在することを確認する • 項目 ID とコレクション ID の精度を確認する |
OperationIsCanceled |
インジェスト操作は完了前に取り消されました。 | • 取り消しが意図的なものかどうかを確認する • システム ログで自動キャンセル トリガーを確認する |
OperationNotExistsInCollection |
このコレクションに対して参照される操作 ID が存在しません。 | • 正しい操作 ID とコレクションを使用していることを確認する |
PatchValidation |
パッチ操作に無効なデータまたは操作が含まれています。 | • パッチが JSON パッチ の仕様に従っていることを確認する • パッチ操作ターゲットの有効なフィールドを確認する |
PostItemCollectionSizeExceeded |
投稿される項目のバッチがサイズ制限を超えています。 | • 1 回の要求でアイテムの数を減らす • 大規模なデータセットには一括インジェスト API を使用する |
PublicAccessRestricted |
ストレージ リソースでは、パブリック アクセスは許可されません。 | アクセス許可に関する問題のトラブルシューティング |
StacValidationFailed |
STAC 項目が検証要件を満たしていません。 | STAC 検証エラーのトラブルシューティング |
TotalAssetsExceeded |
STAC 項目に含まれる資産が多すぎます (最大 100 資産)。 | • アイテムあたりの資産数を 100 未満に減らす •複数の項目に分割 |