外部データ ソース (EDS) プレビューを有効にする方法
外部データ ソース (EDS) は、OSDU® 準拠の外部データ ソースからのデータを Azure Data Manager for Energy リソースと共有できる OSDU® の機能です。 EDS は、スケジュールされたジョブを介して OSDU 準拠のデータ ソースから指定されたデータ (メタデータ) をプルし、関連するデータセット ファイル (LAS、SEG-Y など) を外部ソースに保存してオンデマンドで取得するように設計されています。
外部データ ソース (EDS) の詳細については、「The OSDU Forum 2Q 2022 Newsletter - EDS」を参照してください。
Note
EDS M23 プレビューは、開発者レベルでのみ Azure Data Manager for Energy で利用できるようになりました。
重要
ID プロバイダー (IdP) トークンを読み取り操作のみに制限します。
検索ラッパー API と配信ラッパー API を不正アクセスから保護します。 ベスト プラクティスとして、Azure Data Manager for Energy のみがラッパー API を通じてデータにアクセスできるようにしてください。 これは、EDS プレビューのデータ検出と配信に役立ちます。
前提条件
OSDU® シークレット サービスで管理されるシークレットを格納するために、新しいキー コンテナーを作成するか、既存のキー コンテナーを使用します。 Azure portal を使ってキー コンテナーを作成する方法を学習するには、「クイック スタート: Azure portal を使用してキー コンテナーを作成する」を参照してください。
重要
キー コンテナーは、Azure Data Manager for Energy リソースと同じテナントおよびサブスクリプションに存在する必要があります。
ヒント
キー コンテナーの作成時に、消去保護を有効にします (削除されたコンテナーおよびコンテナー オブジェクトに必須の保持期間を適用します) を選択します。
キー コンテナー (既存または新規) の Azure Data Manager for Energy Service Principal (SPN) にアクセス許可を付与します。 Azure Data Manager for Energy SPN にアクセス権を付与する方法 - Azure Key Vault アクセス ポリシー (CLI) の割り当て | Microsoft Learn。
EDS プレビューを有効にするには、Azure サポート要求を作成します。
Azure Data Manager for Energy で外部データ ソースのプレビューを有効にするには、次の情報を記載した Azure サポート チケットを作成してください。
- サブスクリプション ID
- Azure Data Manager for Energy の Developer レベル リソース名
- データ パーティション名 (EDS-Scheduler の自動トリガーのために EDS を有効にする必要があるデータ パーティション)
- Key Vault 名 ([前提条件] で作成済み)
Note
複数のデータ パーティションのサポートは現在、EDS 取り込み DAG の手動トリガーに対して有効になっていますが、この機能は EDS Scheduler に対してはまだ実装されていません。
Azure Data Manager for Energy リソースで EDS プレビューが有効になると、通知されます。
既知の問題
- 以下の問題は OSDU® M23 リリースに固有のものです。
- EDS インジェスト DAG は、データ提供元のラッパー Search Service を利用できない場合に失敗します。
- EDS データセット サービス応答は、データ提供元のデータセット ラッパー サービスを利用できない場合、空の応答を提供します。
- シークレット サービスは、場合によっては 4xx ではなく 5xx HTTP 応答コードで応答します。 たとえば、 のように指定します。
- アプリケーションが削除されたシークレットを回復しようとした場合、シークレットは削除されません。
- アプリケーションが無効な削除済みシークレットを取得しようとした場合。
制限事項
帰化 DAG ワークフローは、M23 リリースには含まれません。
よく寄せられる質問
「外部データ ソースの FAQ」を参照してください。