この記事では、OSDU® Data Platform の参照データ値の概要と、data Manager for Energy Azureが OSDU® コミュニティ標準との同期にどのように役立つのかについて説明します。
参照データ値とは何か、なぜ重要なのでしょうか。
OSDU データ プラットフォーム® フレームワーク内では、データの一貫性と標準化を確保する上で、参照データ値が重要な役割を果たします。 参照データとは、マスター データや作業製品コンポーネントなど、さまざまなデータ フィールドで使用される属性の許容値のセットを指します。 たとえば、degree Celsius は許可された UnitofMeasure、Billing Address は許可された AddressType です。
データの解釈とコラボレーションを有効にするだけでなく、OSDU® マニフェスト インジェスト ワークフローを使用したデータ インジェストには参照データが必要です。 マニフェストは、参照データ値用の特定のコンテナーを提供します。このコンテナーは、インジェストされたデータを検証し、後で発見して利用するためのメタデータを生成します。 マニフェスト ベースのインジェストの詳細については、「マニフェスト ベースのインジェストの概念」をご覧ください。
OSDU データ プラットフォーム®では、参照データの値が次の 3 つのバケットに分類されます。
- 固定 値: この一連の参照値は、OSDU® デプロイとエネルギー セクター全体で一般的に認識され、使用されます。 OSDU® コミュニティ ガバナンスの更新プログラムを除き、これらの値を拡張または変更することはできません
- OPEN 値: OSDU® コミュニティには、拡張できるが変更できない OPEN 値の初期リストが用意されています
- LOCAL 値: OSDU® コミュニティには、自由に変更、拡張、または完全に置き換えることができる LOCAL 値の初期リストが用意されています
OSDU® 参照データ値とその異なる型の詳細については、「 OSDU® データ定義/データ定義/参照データ」を参照してください。
Azure Data Manager for Energy での値の同期の構成
データの整合性を維持し、相互運用性を容易にするために、新しい Azure Data Manager for Energy インスタンスは、
後で、Azure Data Manager for Energy インスタンスで新しいデータ パーティションを作成すると、FIXED と OPEN の参照値が同期された状態で作成されます。 インスタンスを最初に作成した際に LOCAL 値を追加で同期するよう選択した場合、新しいパーティションはコミュニティからの LOCAL 値も同期します。
Quickstart: 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 では、同期時に参照データ値のLegal Tags および Entitlements が自動的に設定されます。
同期されたすべての参照データ値について、FIXED、OPEN、LOCAL のいずれであっても、法的タグは {data-partition-id}-referencedata-legal に設定されます。ここで、{data-partition-id} は、新しいデータ パーティションの作成を構成するときに指定したデータ パーティション名に対応します。
Entitlements では、Azure Data Manager for Energy によってエンタイトルメント グループが自動的に作成され、アクセス制御に使用できるようになります。 グループは、FIXED、OPEN、LOCAL の各値の所有者と閲覧者向けに作成されます。
| ガバナンス セット | グループ所有者 | 閲覧者グループ |
|---|---|---|
| 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} |
| LOCAL | 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 フィールドを更新する権利を付与します。
OSDU® マイルストーンの自動参照データ値のアップグレード
Azure Data Manager for Energy では、各インスタンスの標準アップグレード サイクルの一部として、最新の OSDU® にアラインされた FIXED、OPEN、LOCAL の値を自動的に適用することで、参照データ値 (RDV) が更新されます。 これらの更新により、インスタンスは進化する OSDU® 定義に合わせて維持され、必要に応じてお客様固有の構成が維持されます。 このアプローチにより、すべての OSDU® ベースのシステム間で FIXED 値が相互運用可能であり、OPEN 値は引き続き顧客の意図を失うことなく拡張性をサポートし、LOCAL 値は組織が依存するビジネス固有の意味を保持します。 更新プログラムはユーザーの操作を必要とせず、ダウンタイムなしでシームレスに実行されます。Azure Data Manager for Energy には、OSDU® が提供する新しい値が組み込まれており、固定値が最新の標準に更新され、OPEN と LOCAL の顧客の変更が保持されます。 RDV バージョン管理は OSDU® バージョンから切り離されているため、Azure Data Manager for Energy では、OSDU® マイルストーンのアップグレード中に RDV 更新プログラムonlyが適用され、予測可能で管理されたロールアウトが保証されます。
参照データ値の更新動作の概要
| RDV の種類 | アップグレード ビヘイビアー | 根拠 |
|---|---|---|
| 固定 | 最新の OSDU® 標準に更新されました。以前のバージョンは履歴にアクセスできます。 | OSDU® ベースのシステム間のグローバルな相互運用性を確保します。 |
| OPEN | お客様が拡張または変更したエントリは保持されます。新しい OSDU® ベースライン エントリは、ユーザーの変更を上書きせずに追加されます。 | 共有セマンティクスとユーザー主導の拡張性のバランスを取ります。 |
| ローカル |
動作は、インスタンスのプロビジョニングの選択に従います。カスタム値は変更されず、LOCAL が有効になっている場合にのみ新しい OSDU® 候補が追加されます。 | ビジネス固有の意味を保護し、意図しない変更を回避します。 |
Azure Data Manager for Energy でサポートされている現在のマイルストーンと使用可能な OSDU® サービスの詳細については、「Azure Data Manager for Energy で利用可能な