共用方式為

如何啟用外部資料來源 (EDS) 預覽版？

  • 發行項

外部資料來源 (EDS) 是 OSDU® 中的功能，可讓來自 OSDU® 相容外部資料來源的資料，能與適用於能源產業的 Azure 資料管理員共用。 EDS 設計透過排程作業從符合 OSDU 規範的資料來源提取指定的資料 (中繼資料)，同時將相關聯的資料集檔案 (LAS、SEG-Y 等) 儲存在外部資源，以視需要擷取。

如需外部資料來源 (EDS) 的詳細資訊，請參閱 OSDU 論壇 2022 年第 2 季電子報 - EDS。

注意

EDS M23 預覽版現在僅適用於開發人員階層中的 Azure Data Manager for Energy 上。

重要

將您的識別提供者 (IdP) 權杖限制為僅限讀取作業。

保護您的搜尋和傳遞包裝函式 API，免於遭到未經授權的存取。 最佳做法是確保只有 Azure Data Manager for Energy 可透過包裝函式 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 Key Vault 存取原則 (CLI) | Microsoft Learn。

    1. 在 [存取原則] 之下，選取 [建立] 以建立存取原則：
      1. 在 [權限] 索引標籤中，選取權限。 選取權限的螢幕擷取畫面。
      2. 在 [主體] 選取窗格底下，輸入 AzureEnergyRpaaSAppProd。 建立存取原則的螢幕擷取畫面。
      3. 檢閱 + 建立存取原則。

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

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

  • 訂用帳戶識別碼
  • Azure Data Manager for Energy 開發人員階層資源名稱
  • 資料分割名稱 (需要啟用 EDS 的資料分割，才能自動觸發 EDS-Scheduler)
  • Key Vault 名稱 (在必要條件中建立)

注意

目前已啟用多個資料分割支援，以便手動觸發 EDS 內嵌 DAG，但此功能尚未針對 EDS 排程器實作。

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

已知問題

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

限制

歸化 DAG 工作流程不會包含在 M23 版本中。

常見問題集

請參閱外部資料來源常見問題。

如何向 Azure Data Manager for Energy 註冊外部資料來源？