参照データ値の同期
重要
Azure Data Manager for Energy データ パーティションの参照値を同期する機能は、現在、限定プレビュー段階にあります。 Azure サブスクリプションでこの機能を有効にすることに関心がある場合は、Microsoft Sales の連絡先にお問い合わせになるか、サポート チケットを開いてください。
この記事では、OSDU Data Platform の参照データ値の概要と、Azure Data Manager for Energy が OSDU コミュニティ標準との同期にどのように役立つのかについて説明します。
参照データ値とは何か、なぜ重要なのでしょうか。
OSDU Data Platform フレームワーク内では、データの一貫性と標準化を確保する上で、参照データ値が重要な役割を果たします。 参照データとは、マスター データや作業製品コンポーネントなど、さまざまなデータ フィールドで使用される属性の許容値のセットを指します。 たとえば、degree Celsius は許可された UnitofMeasure であり、Billing Address は許可された AddressType です。
参照データは、データの解釈と共同作業を有効にするだけでなく、OSDU マニフェスト インジェスト ワークフローを使用したデータ インジェストに必要です。 マニフェストは、参照データ値用の特定のコンテナーを提供します。このコンテナーは、インジェストされたデータを検証し、後で発見して利用するためのメタデータを生成します。 マニフェスト ベースのインジェストの詳細については、「マニフェスト ベースのインジェストの概念」をご覧ください。
OSDU Data Platform では、参照データの値が次の 3 つのバケットに分類されます。
- FIXED 値: この一連の参照値は、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 でサポートされている現在のマイルストーンに対して、OSDU コミュニティからの最新のセットに従って同期された FIXED および OPEN 参照データ値で自動的に作成されます。 さらに LOCAL 値を同期して、新しいインスタンスを作成することもできます。
その後、Azure Data Manager for Energy インスタンスで新しいデータ パーティションを作成すると、FIXED と OPEN の参照値が同期された状態で作成されます。 インスタンスを最初に作成した際に LOCAL 値を追加で同期するよう選択した場合、新しいパーティションはコミュニティからの LOCAL 値も同期します。
「クイック スタート: Azure Data Manager for Energy インスタンスを作成する」の記事で説明されているように、新しい Azure Data Manager for Energy インスタンスの作成時に LOCAL 値の同期を有効にするよう選択できます。 Azure portal を使用してデプロイする場合は、[詳細設定] タブで 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 の各値の所有者と閲覧者向けに作成されます。
| ガバナンス セット | 所有者グループ | 閲覧者グループ |
|---|---|---|
| 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 では、機能を有効化した後のインスタンス作成時と新しく作成されたインスタンスの新しいパーティションの作成時に、参照データ値が同期されます。 参照値は、インスタンスまたはパーティションの作成時に Azure Data Manager for Energy によってサポートされる OSDU マイルストーンに対応する OSDU コミュニティの値と同期されます。 Azure Data Manager for Energy でサポートされている現在のマイルストーンと使用可能な OSDU サービスの詳細については、Azure Data Manager for Energy で利用できる OSDU サービスについての記事を参照してください。