本文概述了 OSDU® 資料平台中的參考資料值，並說明 Azure 能源資料管理器如何幫助您將其與 OSDU® 社群標準同步。
什麼是參考資料值，為什麼它們很重要？
在OSDU資料平台®框架中，參考資料值在確保資料一致性與標準化方面扮演關鍵角色。 參考資料是指可用於各種資料欄位的一組允許值，例如主資料或工作成品元件。 例如，degree Celsius 是允許的 UnitofMeasure，而 Billing Billing Address 是允許的 AddressType。
除了支援資料解讀與協作外，參考資料也需透過 OSDU® 清單資料擷取工作流程進行資料擷取。 資訊清單會為參考資料值提供特定的容器，然後用來驗證擷取的資料，並產生中繼資料以供後續探索與使用。 若要深入了解以資訊清單為基礎的擷取，請參閱以資訊清單為基礎的擷取概念。
OSDU 資料平台®將參考資料值分為以下三個分類桶：
- 固定 值：這組參考值在OSDU®部署及能源領域中被普遍認可並使用。 這些價值觀除非透過 OSDU® 社群治理更新，否則無法被擴展或改變
- 開放 值：OSDU® 社群提供一份初始的開放值清單，您可以在此基礎上擴展，但不能更改
- 在地 價值觀：OSDU® 社群提供一份初步的在地價值觀清單，你可以自由更改、擴展或完全替換
欲了解更多關於 OSDU® 參考資料值及其不同類型，請參閱 OSDU® 資料定義 / 資料定義 / 參考資料。
在 Azure 數據管理器中配置價值同步（能源專用）
為協助您維護資料完整性並促進互通性，新的 Azure 能源資料管理器實例會自動建立，並依照 OSDU® 社群的最新版本，同步當前 Azure 能源資料管理器支援的里程碑中的 FIXED 和 OPEN 參考資料值。 在佈建期間，您也可以選擇使用同步的 LOCAL 值來建立新執行個體，或選擇退出。
稍後，如果您在適用於能源的 Microsoft Azure 資料管理員執行個體中建立新的資料分割，系統也會建立並同步 FIXED 和 OPEN 參考值。 如果您在初次建立執行個體時選擇額外同步 LOCAL 值，新分割也會從社群同步 LOCAL 值。
如同 快速入門：為能源實例建立Azure資料管理器文章所述，你可以在建立新的能源實例Azure資料管理器時，選擇啟用本地值同步。 透過 Azure 入口網站部署時，可以在「進階設定」標籤中啟用本地同步。新實例建立時，FIXED 和 OPEN 參考值都會同步。
透過 ARM 範本部署時，您可以將 ReferenceDataProperties 屬性設定為 All 以啟用 LOCAL 同步。 若要將同步限制為僅 FIXED 和 OPEN 值，請將其值設定為 NonLocal。
同步之參考值的法律標記與權利
Azure 能源資料管理員會自動設定 Legal Tags 和 Entitlements 作為參考資料值，因為這些值正在同步。
對於所有已同步的參考資料值，不論是 FIXED、OPEN 或 LOCAL，法律標記都會設定為 {data-partition-id}-referencedata-legal，其中 {data-partition-id} 對應於您在設定新資料分割建立時所提供的資料分割名稱。
對於 Entitlements，Azure 能源資料管理員會自動建立權利群組，供你用於存取控制。 系統會為 FIXED、OPEN 和 LOCAL 值建立 OWNERS 和 VIEWERS 群組：
| 治理集 | OWNERS 群組 | VIEWERS 群組 |
|---|---|---|
| 定型 | 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} |
| LOCAL | data.referencedata-local.owners@{data_partition_id}.{osdu_domain} | data.referencedata-local.viewers@{data_partition_id}.{osdu_domain} |
上述 LOCAL 群組只會在您選擇同步 LOCAL 值時建立。
如果您在建立執行個體後延伸 OPEN 值，我們建議建立並使用不同的存取控制清單來控管其存取。 例如，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 欄位的權利。
OSDU® 里程碑自動化參考資料值升級
Azure Data Manager for Energy 會透過自動套用最新的符合OSDU® 標準的 FIXED、OPEN 和 LOCAL 值，來更新參考資料值（RDV），這些更新是每個實例標準升級週期的一部分。 這些更新讓實例與不斷演進的 OSDU® 定義保持一致，同時在適當情況下保留客戶專屬的配置。 此方法確保固定值在所有基於 OSDU® 的系統間保持互通性，開放值持續支援擴充性而不失客戶意圖，而本地值則保有組織依賴的業務專屬意義。 更新無需使用者操作，且無縫進行，無停機——Azure 能源資料管理員整合了 OSDU® 提供的新值，將固定值更新至最新標準，並保留客戶對 OPEN 與 LOCAL 的變更。 由於 RDV 版本管理與 OSDU® 版本解耦，Azure 能源資料管理器只會在 OSDU® 的整體里程碑升級過程中套用 RDV 更新，確保可預測且受控的部署。
參考資料值更新行為摘要
| RDV 類型 | 升級行為 | 理由 |
|---|---|---|
| 固定 | 更新至最新的OSDU®標準;先前版本仍可在歷史中取得。 | 確保基於 OSDU® 系統的全球互通性。 |
| OPEN | 系統會保留客戶延伸或修改的項目，並在不覆寫使用者變更的情況下新增新的 OSDU® 基準項目。 | 在共享語意與使用者驅動的擴充性之間取得平衡。 |
| LOCAL | 行為會依照實例的配置選擇而改變;自訂值保持不變，且只有啟用 LOCAL 時才會新增新的 OSDU® 建議。 | 保護企業特定的意義，避免無意間的修改。 |
過期的合法車牌與RDV升級
在自動化的 RDV 升級期間，Azure Data Manager for Energy 會先驗證與現有參考資料紀錄相關的法律標籤，然後再套用更新。 若資料分割區包含過期的法定標籤紀錄，則適用以下行為：
- 系統會略過具有已過期法律標記的現有 RDV — 升級程序會略過法律標記已過期之記錄的更新，而不會讓整個資料分割區的升級失敗。 這些紀錄會維持目前版本，直到法律標籤問題解決。
- 新的 RDV 仍會被新增 — 最新 OSDU® 里程碑中引入的新參考資料值已成功新增，因為它們獲得新的法律標籤，且不受先前已過期標籤的影響。
- 不會發生資料遺失 ——跳過的紀錄不會被刪除或修改。 一旦你續約或更換過期的合法車牌，這些紀錄即可在下一個里程碑週期中升級。
備註
為了確保所有參考資料值在里程碑更新時都已升級，請確認資料分割區中沒有合法標籤過期。 你可以在 Azure Data Manager for Energy 的儲存服務日誌 中找出已過期的合法標籤驗證失敗。
關於目前在 Azure 能源資料管理器中支援及可用的 OSDU® 里程碑資訊，請參考 Azure 能源資料管理器中的 OSDU® 服務。