如何啟用外部資料來源 （EDS） 預覽？

外部數據源 （EDS） 是 OSDU® 中的一項功能，可讓來自符合 OSDU® 規範的外部數據源的數據與適用於能源的 Azure 數據管理員共用。 EDS 的設計目的是透過排程工作從符合 OSDU 規範的數據源提取指定的數據，同時保留儲存在外部來源的相關聯數據集檔案（LAS、SEG-Y 等），以便視需要擷取。

如需外部數據源的詳細資訊（EDS），請參閱 OSDU論壇2022年2022年2022年電子報 - EDS。

注意

OSDU 社群在 M18 版本中以預覽功能的形式出貨 EDS，且僅可在開發人員層的 Azure Data Manager for Energy 上作為預覽功能。

重要

將您的識別提供者 （IdP） 令牌限讀取作業。

保護您的搜尋和傳遞包裝函式 API 免於未經授權的存取。 最佳做法是確保只有適用於能源的 Azure Data Manager 可以透過包裝函式 API 存取數據。 這有助於EDS預覽版的數據探索和傳遞。

必要條件

1. 建立新的，或使用現有的密鑰保存庫來儲存 OSDU® 秘密服務所管理的秘密。 若要了解如何使用 Azure 入口網站建立金鑰保存庫，請參閱快速入門：使用 Azure 入口網站建立金鑰保存庫。

   重要

   您的密鑰保存庫必須存在於與您的 Azure Data Manager for Energy 資源相同的租使用者和訂用帳戶中。

   提示

   當您建立金鑰保存庫時，請選取 [啟用清除保護] （為已刪除的保存庫和保存庫物件強制執行強制保留期限）。

2. 在 [存取組態] 索引卷標的 [許可權模型] 底下，選取 [保存庫存取原則]。

3. 在密鑰保存庫上授與 Azure Data Manager for Energy Service Principal （SPN） 的許可權（現有或新的）。 如何授與 Azure Data Manager for Energy SPN 的存取權 - 指派 Azure 金鑰保存庫 存取原則 （CLI） |Microsoft Learn。

   1. 在 [存取原則] 底下，選取 [建立] 以建立存取原則：
      1. 在 [許可權] 索引標籤中，選取許可權。
      2. 在 [主體] 選取窗格底下，輸入 AzureEnergyRpaaSAppProd。
      3. 檢閱 + 建立存取原則。

若要啟用 EDS 預覽，請建立 Azure 支援 要求

若要在 Azure Data Manager for Energy 上啟用外部數據源預覽，請使用下列資訊建立 Azure 支援 票證：

• 訂用帳戶識別碼
• 適用於能源的 Azure Data Manager 開發人員層資源名稱
• 資料分割名稱（需要啟用 EDS 的數據分割）
• 金鑰保存庫 名稱 （在必要條件中建立）

注意

EDS 沒有 多重數據分割支援

我們在 Azure Data Manager for Energy 資源中啟用 EDS 預覽後通知您。

已知問題

• 以下是OSDU® M18 版本特有的問題：
  • 當數據供應商的包裝函式 搜尋服務 無法使用時，EDS 內嵌 DAG 會導致失敗。
  • 當數據供應商的數據集包裝函式服務無法使用時，EDS 數據集服務回應會提供空的回應。
  • 在某些情況下，秘密服務會回應 5xx HTTP 回應碼，而不是 4xx。 例如，
    • 當應用程式嘗試復原已刪除的秘密時，不會刪除。
    • 當應用程式嘗試取得無效的已刪除秘密時。

限制

某些 EDS 功能，例如 自然化、反向自然化、參考數據對應 ，在 M18 OSDU® 版本中無法使用（稍後版本提供），因此無法在 Azure Data Manager for Energy M18 版本中使用。 一旦升級至後續 的OSDU® 里程碑版本，即可使用這些功能。

常見問題集

請參閱 外部數據源常見問題。

如何向 Azure Data Manager for Energy 註冊外部數據源？