Azure Synapse Link for Dataverse から選択ラベルに直接アクセスする
Microsoft Dataverse は Power Apps 内で直接使用できる豊富なメタデータを提供します。 選択肢 (候補リスト) は、テーブルに含めることができる列の中で最もよく使用されるタイプの 1 つです。 一連のオプションを定義します。 選択肢はフォームに表示されるとき、ドロップダウン リスト コントロールを使用します。 選択肢を定義して、それ自身で (ローカルに) 定義された一連のオプションを使用することも、ほかの選択肢列で使用できる他の場所で (グローバルに) 定義された一連のオプションを使用することもできます。
選択肢列の詳細については、グローバル選択肢の概要を作成および編集するに移動してください。
Azure Synapse Link の作成後、次の 5 つのテーブルが Azure Data Lake Storage Gen2 の OptionsetMetadata という名前のフォルダーに作成されます:
- OptionsetMetadata
- GlobalOptionsetMetadata
- StateMetadata
- StatusMetadata
- TargetMetadata
StateMetadata と StatusMetadata には、取得する State と Status 選択値が格納されます。 TargetMetadata には取得するテーブル リレーションシップ メタデータが格納されます。
| 列名 | データ型 | サンプルの値 | 説明 |
|---|---|---|---|
| EntityName | 文字列 | アカウント | 現在の Dataverse テーブル名。 |
| AttributeName | 文字列 | transactioncurrencyid | 現在の列名 |
| ReferencedEntity | 文字列 | transactioncurrency | 関連する Dataverse テーブル名 |
| ReferencedAttribute | 文字列 | transactioncurrencyid | 関連する列名 |
詳細情報: テーブルの関連付けの概要。
OptionsetMetadata では、インポートされた Dataverse テーブルにローカル選択ラベル メタデータを格納されます。 GlobalOptionsetMetadata では、グローバル選択ラベル メタデータが格納され、同じテーブル スキーマに加えて、テーブルと選択肢名の組み合わせである GlobalOptionSetName という追加の列があります。
| 列名 | データ型 | サンプルの値 | 説明 |
|---|---|---|---|
| EntityName | 文字列 | アカウント | Dataverse テーブル名。 |
| OptionSetName | 文字列 | ownershipcode | 列名。 |
| オプション | Bigint | 1 | 選択項目の作成時に、ユーザー指定した数値ラベル。 |
| IsUserLocalizedLabel | ブール値 | False | 既定で False を返します。 |
| LocalizedLabelLanguageCode | Bigint | 1033 | 英語 (米国) の場合は 1033、スペイン語 (United States) の場合は 1034など、選択肢ラベルの言語コード。 |
| LocalizedLabel | 文字列 | パブリック | 選択項目の作成時に、ユーザー指定したテキスト ラベル。 |
| GlobalOptionSetName (GlobalOptionsetMetadata のみ) | 文字列 | socialprofile_community | テーブルと選択肢名の組み合わせ |
Dataverse テーブルで、選択列にはユーザー指定の数値が含まれます。これは、上記の OptionsetMetadata テーブルでオプションと同じ値です。
前提条件
Azure Synapse Link for Dataverse。 この記事では、Azure Synapse Link for Dataverse を使用して Dataverse からデータをすでにエクスポートしていることを前提としています。
選択肢メタデータにアクセスする
- 希望の Azure Synapse Link を選択し、コマンド バーから Azure Synapse Analytics ワークスペースに移動する を選択します。
- 左側ウィンドウから レイク データベースを展開し、dataverse-environmentName-organizationUniqueName を選択してから、 テーブルを展開します。 一覧表示されているすべての選択肢メタデータを分析用に使用できます。
サーバーレス SQL プールで Dataverse 選択肢列を使用するには。
- データベース アイコンを右クリックしてから、新しい SQL スクリプト > 空のスクリプトを選択します。
- 結合 SQL スクリプトを適用して、選択肢メタデータを Dataverse テーブルに結合させ、ビューを新しいデータベースに保存します。
選択肢メタデータを結合する SQL スクリプトの例
<DATABASE_NAME>、<COLUMN_NAME>、および <TABLE_NAME> をデータベースの名前、列の名前、およびテーブルの名前に置き換えると、数値の選択値が意味のあるテキスト ラベルに置き換わります
SELECT [LocalizedLabel] as [<COLUMN_NAME>]
FROM [<DATABASE_NAME>].[dbo].[<TABLE_NAME>_partitioned]
LEFT JOIN [<DATABASE_NAME>].[dbo].[OptionsetMetadata]
ON ([<DATABASE_NAME>].[dbo].[OptionsetMetadata].[Option] = [<DATABASE_NAME>].[dbo].[<TABLE_NAME>_partitioned].[<COLUMN_NAME>] AND [<DATABASE_NAME>].[dbo].[OptionsetMetadata].[OptionSetName] = <COLUMN_NAME>)
複数のオプション セット値を使用する方法の詳細については、共通テーブル式の使用を使用する必要があります。