Microsoft プラネタリー コンピューター Pro にデータを取り込む

Microsoft プラネタリー コンピューター Pro インジェスト機能を使用すると、ユーザーは、大規模な地理空間資産のインデックス作成、格納、クエリに効果的なクラウド対応プラットフォームに独自のデータを取り込めます。 惑星コンピューター Pro GeoCatalog に取り込んで格納されたデータは、SpatioTemporal Asset Catalog (STAC) オープン標準を使用して、地理空間データのインデックス作成、クエリ、および取得を行います。 STAC の詳細については、 STAC の概要を参照してください。

この図は、インジェスト サービスのさまざまな要素がどのように連携するかの概要を示しています。

Microsoft プラネタリー コンピューター Pro での安全なインジェストを示す図。

[前提条件]

取込元ソース

インジェスト ソース は、GeoCatalog リソースにデータを取り込むのに必要な場所と認証メカニズムの表現です。 ユーザーは、Web インターフェイスの [設定] タブまたは GeoCatalog API を使用して、インジェスト ソースを一覧表示および構成できます。 インジェスト ソースが設定されると、その場所に格納されているデータを GeoCatalog への安全なインジェストに使用できます。

[設定] ボタンが配置されている場所を示す GeoCatalog ポータルのスクリーンショット。

サポートされているストレージの種類

プラネタリー コンピューター Pro では、次のストレージ ソースからの地理空間資産の取り込みをサポートしています。

  • マネージド ID と SAS トークンを使用した Azure Blob Storage
  • 公開URL
  • 署名されたキーを持つ S3 バケット

Warnung

プラネタリーコンピュータプロに取り込まれるすべてのデータには 、STAC項目が必要です。

ヒント

STACアイテムの作成を加速するために、 詳細なチュートリアル があり、 STAC Forgeと呼ばれるオープンソースツールもあります。

インジェスト方法

BLOB ストレージ コンテナーやパブリック URL などのインジェスト ソースを指定すると、Planetary Computer Pro はデータにアクセスできます。 指定した場所に格納されている STAC コレクション、STAC 項目、および資産を、プラネタリー コンピューター Pro に取り込むことができます。 GeoCatalog リソースは、STAC コレクション JSON と、STAC コレクション STAC 項目が指す地理空間アセット (画像、データなど) の両方にアクセスできる必要があります。

インジェスト プロセス中に、GEOTIFF、JPEG、JPEG2000、PNG、TIFF のファイルは COG (クラウド最適化 GeoTIF) に変換されますが、ユーザーは元のファイルをコピーするオプションも選択できます。

既に COG 形式のデータは変換されません。

インジェストでは、さまざまなデータ キューブ形式のクラウド最適化もサポートされています。「 データ キューブの概要 ユーザーは、カタログ内の特定の項目をスキップするように選択することもできます」を参照してください。

ユース ケースに応じて、 一括インジェスト単一アイテム インジェストという 2 つのインジェスト方法があります。 それぞれは、Web インターフェイスまたは API を使用して実行できます。

一括インジェスト

一括インジェストを使用すると、ユーザーは、コレクション JSON ファイル、関連付けられている STAC 項目、基になる STAC 資産 (イメージ、データなど) を含む既存の STAC コレクションを自動的に取り込むことができます。 一括インジェストでは、データ ソース (Blob Storage など)、接続 URL、項目の種類を指定することで、これらの成果物をすばやく GeoCatalog に移動します。 一括インジェストでは、これらの入力とパラメーターを使用してインジェスト ワークフローを実行します。 一括インジェストの詳細については、「一括インジェスト API を使用して GeoCatalog にデータを取り込む」を参照してください。

一括インジェスト GUI のスクリーンショット。

単一アイテム インジェスト

GeoCatalog 内に既存の STAC コレクションがある場合、ユーザーは、プラネタリー コンピューター Pro の Web インターフェイスまたは API を使用して、新規または既存の STAC 項目とそれに関連付けられている資産を取り込むことができます。 プラネタリー コンピューター Pro の一括インジェスト機能とは異なり、単一アイテムインジェストは、待機時間の短いインポートまたは更新と大規模なデータ移行を目的としています。 一括インジェストの詳細については、「 STAC 項目をコレクションに追加する」を参照してください。

単一項目インジェスト GUI のスクリーンショット。

インジェストのトラブルシューティング

認証エラー、STAC 検証エラー、資産変換の問題など、データ インジェスト中に問題が発生した場合は、専用のトラブルシューティング ドキュメントを参照してください。

次のステップ

インジェスト ソースを設定する方法の詳細については、以下を参照してください。