外部データ ソース (EDS) プレビューを有効にする方法

外部データ ソース (EDS) は、OSDU® 準拠の外部データ ソースからのデータを Azure Data Manager for Energy リソースと共有できる OSDU® の機能です。 EDS は、スケジュールされたジョブを介して OSDU 準拠のデータ ソースから指定されたデータ (メタデータ) をプルし、関連するデータセット ファイル (LAS、SEG-Y など) を外部ソースに保存してオンデマンドで取得するように設計されています。

外部データ ソース (EDS) の詳細については、「The OSDU Forum 2Q 2022 Newsletter - EDS」を参照してください。

Note

OSDU コミュニティは M18 リリースで EDS をプレビュー機能として出荷し、Azure Data Manager for Energy では Developer レベルのみのプレビュー機能として利用できます。

重要

ID プロバイダー (IdP) トークンを読み取り操作のみに制限します。

検索ラッパー API と配信ラッパー API を不正アクセスから保護します。 ベスト プラクティスとして、Azure Data Manager for Energy のみがラッパー API を通じてデータにアクセスできるようにしてください。 これは、EDS プレビューのデータ検出と配信に役立ちます。

前提条件

  1. OSDU® シークレット サービスで管理されるシークレットを格納するために、新しいキー コンテナーを作成するか、既存のキー コンテナーを使用します。 Azure portal を使ってキー コンテナーを作成する方法を学習するには、「クイック スタート: Azure portal を使用してキー コンテナーを作成する」を参照してください。

    重要

    キー コンテナーは、Azure Data Manager for Energy リソースと同じテナントおよびサブスクリプションに存在する必要があります。

  2. [アクセス構成] タブで、[アクセス許可モデル] の下にある [コンテナー アクセス ポリシー] を選択します。 キー コンテナーの作成のスクリーンショット。

  3. キー コンテナー (既存または新規) の Azure Data Manager for Energy Service Principal (SPN) にアクセス許可を付与します。 Azure Data Manager for Energy SPN にアクセス権を付与する方法 - Azure Key Vault アクセス ポリシー (CLI) の割り当て | Microsoft Learn

    1. [アクセス ポリシー] で、[作成] を選択してアクセス ポリシーを作成します。
      1. [アクセス許可] タブで、アクセス許可を選択します。 アクセス許可の選択のスクリーンショット。
      2. [プリンシパルの選択] ウィンドウで、AzureEnergyRpaaSAppProd と入力します。 アクセス ポリシーの作成のスクリーンショット。
      3. アクセス ポリシーを確認および作成します。

EDS プレビューを有効にするには、Azure サポート要求を作成します。

Azure Data Manager for Energy で外部データ ソースのプレビューを有効にするには、次の情報を記載した Azure サポート チケットを作成してください。

  • サブスクリプション ID
  • Azure Data Manager for Energy の Developer レベル リソース名
  • データ パーティション名 (EDS を有効にする必要があるデータ パーティション)
  • Key Vault 名 ([前提条件] で作成済み)

Azure Data Manager for Energy リソースで EDS プレビューが有効になると、通知されます。

既知の問題

  • 以下の問題は OSDU® M18 リリースに固有のものです。
    • EDS インジェスト DAG は、データ提供元のラッパー Search Service を利用できない場合に失敗します。
    • EDS データセット サービス応答は、データ提供元のデータセット ラッパー サービスを利用できない場合、空の応答を提供します。
    • シークレット サービスは、場合によっては 4xx ではなく 5xx HTTP 応答コードで応答します。 たとえば、 のように指定します。
      • アプリケーションが削除されたシークレットを回復しようとした場合、シークレットは削除されません。
      • アプリケーションが無効な削除済みシークレットを取得しようとした場合。

制限事項

帰化、逆帰化、参照データのマッピングなどの一部の EDS 機能は、M18 OSDU® リリースでは使用できないため (それ以降のリリースでは使用可能)、Azure Data Manager for Energy M18 リリースでは使用できません。 これらの機能は、以降の OSDU® マイルストーン リリースにアップグレードすると利用できるようになります。

よく寄せられる質問

外部データ ソースの FAQ」を参照してください。