你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

如何启用外部数据源 (EDS) 预览版？

  • 项目

外部数据源 (EDS) 是 OSDU® 中的一项功能，它允许来自符合 OSDU® 的外部数据源的数据与 Azure Data Manager for Energy 资源共享。 EDS 能够通过计划作业从符合 OSDU 的数据源拉取指定的数据（元数据），同时将关联的数据集文件（LAS、SEG-Y 等）存储在外部源中，以便按需检索。

有关外部数据源 (EDS) 的详细信息，请参阅 OSDU 论坛 2Q 2022 新闻稿 - EDS。

注意

OSDU 社区在 M18 版本中以预览功能的形式发布了 EDS，它仅在开发人员层中作为 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 服务主体 (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 开发人员层资源名称
  • 数据分区名称（需要启用 EDS 的数据分区）
  • Key Vault 名称（在先决条件中创建）

注意

EDS 没有多数据分区支持

当 EDS 预览版在你的 Azure Data Manager for Energy 资源中启用后，我们会通知你。

已知问题

  • 以下问题特定于 OSDU® M18 版本：
    • 当数据供应商的包装器搜索服务不可用时，EDS 引入 DAG 会导致失败。
    • 当数据供应商的数据集包装器服务不可用时，EDS 数据集服务响应会提供空响应。
    • 在某些情况下，机密服务会使用 5xx HTTP 响应代码而不是 4xx 进行响应。 例如：
      • 当应用程序尝试恢复已删除的机密而它未被删除时。
      • 当应用程序尝试获取无效的已删除机密时。

限制

某些 EDS 功能（如归化、反向归化、参考数据映射）在 M18 OSDU® 版本中不可用（在更高版本中可用），因此在 Azure Data Manager for Energy M18 版本中不可用。 升级到后续 OSDU® 里程碑版本后，即可使用这些功能。

常见问题解答

请参阅外部数据源 FAQ。

如何将外部数据源注册到 Azure Data Manager for Energy？