你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
同步参考数据值
重要
用于同步 Azure Data Manager for Energy 数据分区中参考值的功能目前处于“受限预览版”状态。 如果有兴趣为 Azure 订阅启用此功能，请联系 Microsoft Sales 联系人或开具支持工单以获取帮助。
本文概述了 OSDU 数据平台中的参考数据值，并介绍了 Azure Data Manager for Energy 如何帮助你将其与 OSDU 社区标准同步。
什么是参考数据值，为什么它们很重要？
在 OSDU 数据平台框架中，参考数据值在确保数据一致性和标准化方面发挥着重要作用。 参考数据是指在各种数据字段（如主数据或工作产品组件）中使用的属性的一组允许的值。 例如，degree Celsius 是允许的 UnitofMeasure，Billing Address 是允许的 AddressType。
除了启用数据解释和协作之外，还需要提供参考数据通过 OSDU 清单引入工作流进行数据引入。 清单提供参考数据值的特定容器，然后用于验证引入的数据，并生成元数据供以后发现和使用。 若要详细了解基于清单的引入，请参阅基于清单的引入概念。
OSDU 数据平台将参考数据值分类为以下三个存储桶：
- FIXED 值：这组参考值在 OSDU 部署和能源部门之间得到普遍认可和使用。 这些值不能扩展或更改，除非 OSDU 社区治理更新
- OPEN 值：OSDU 社区提供了一个 OPEN 值的初始列表，你可以扩展，但不能更改
- LOCAL 值：OSDU 社区提供了一个 LOCAL 值的初始列表，你可以随意更改、扩展或完全替换这些值
有关 OSDU 参考数据值及其不同类型的详细信息，请参阅 OSDU 数据定义/数据定义/参考数据。
在 Azure Data Manager for Energy 中配置值同步
为了帮助你维护数据完整性并促进互操作性，将使用 FIXED 和 OPEN 参考数据值自动创建新的 Azure Data Manager for Energy 实例，这些参考数据值会依据 OSDU 社区中的最新数据集，针对当前 Azure Data Manager for Energy 支持的里程碑进行同步。 还可以选择使用同步的 LOCAL 值创建新实例。
稍后，如果在 Azure Data Manager for Energy 实例中创建新的数据分区，还会使用已同步的 FIXED 和 OPEN 参考值创建它们。 如果选择在首次创建实例时额外同步 LOCAL 值，则新分区还会同步社区中的 LOCAL 值。
如快速入门：创建 Azure Data Manager for Energy 实例文章中所述，可以选择在创建新的 Azure Data Manager for Energy 实例时启用 LOCAL 值同步。 通过 Azure 门户进行部署时，可以在“高级设置”选项卡中启用 LOCAL 同步。创建新实例时，FIXED 和 OPEN 参考值将始终同步。
通过 ARM 模板进行部署时，可以通过将 ReferenceDataProperties 属性设置为 All 来启用 LOCAL 同步。 若要仅将同步限制为 FIXED 和 OPEN 值，请将它的值设置为 NonLocal。
同步参考值的法律标记和权利
Azure Data Manager for Energy 自动为参考数据值设置“法律标记”和“权利”，因为它们是同步的。
对于所有同步的参考数据值（无论是 FIXED、OPEN 还是 LOCAL），“法律标记”都设置为 {data-partition-id}-referencedata-legal，其中 {data-partition-id} 对应于配置新数据分区创建时提供的数据分区名称。
对于“权利”，Azure Data Manager for Energy 会自动创建权利组，然后可用于访问控制。 在 FIXED、OPEN 和 LOCAL 值中为 OWNERS 和 VIEWERS 创建组：
| 治理集 | OWNERS 组 | VIEWERS 组 |
|---|---|---|
| FIXED | data.referencedata.owners@{data_partition_id}.{osdu_domain} | data.referencedata.viewers@{data_partition_id}.{osdu_domain} |
| OPEN | data.referencedata.owners@{data_partition_id}.{osdu_domain} | data.referencedata.viewers@{data_partition_id}.{osdu_domain} |
| 本地 | data.referencedata-local.owners@{data_partition_id}.{osdu_domain} | data.referencedata-local.viewers@{data_partition_id}.{osdu_domain} |
仅当你选择同步 LOCAL 值时，才会创建上述 LOCAL 组。
如果在创建实例后扩展 OPEN 值，建议创建和使用不同的访问控制列表 (ACL) 来管理其访问。 例如，data.referencedata-{ORG}.owners@{data_partition_id}.{osdu_domain} 和 data.referencedata-{ORG}.viewers@{data_partition_id}.{osdu_domain}，其中 {ORG} 将 ACL 与创建时同步的标准 OPEN 值所使用的 ACL 区分开来。
NameAlias 更新不需要单独的权利。 对 NameAlias 字段的更新与对存储记录的任何其他部分的更新采用相同的访问控制机制。 实际上，OWNER 访问权限授予更新 NameAlias 字段的权利。
当前 Azure Data Manager for Energy 参考数据值同步范围
目前，Azure Data Manager for Energy 会在创建实例时同步参考数据值，并且在功能启用后为新创建的实例创建新分区时，也会同步这些参考数据值。 参考值与 OSDU 社区中的参考值同步，对应于创建实例或分区时 Azure Data Manager for Energy 支持的 OSDU 里程碑。 有关 Azure Data Manager for Energy 中当前支持的里程碑和可用的 OSDU 服务的信息，请参阅 Azure Data Manager for Energy 中提供的 OSDU 服务。