Microsoft Dataverse には、Power Apps 内で直接使用できる豊富なメタデータが用意されています。 選択肢 (選択リスト) は、テーブルに含めることができる最も使用される列の種類の 1 つです。 これは、一連のオプションを定義します。 選択項目がフォームに表示されると、ドロップダウン リスト コントロールが使用されます。 (ローカル) 内で定義された一連のオプションを使用するように選択を定義することも、他の選択肢列で使用できる他の場所 (グローバルに) 定義された一連のオプションを使用することもできます。
選択肢列の詳細については、「グローバル選択肢の 作成と編集の概要」を参照してください。
Azure Synapse Link を作成すると、Azure Data Lake Storage Gen2 の OptionsetMetadata という名前のフォルダーに次の 5 つのテーブルが作成されます。
- OptionsetMetadata
- グローバルオプションセットメタデータ
- StateMetadata
- ステータスメタデータ
- TargetMetadata
StateMetadata と StatusMetadata には、取得する 状態 と 状態 の選択値が格納されます。 TargetMetadata には、取得するテーブル リレーションシップメタデータが格納されます。
| 列名 | データの種類 | サンプル値 | Description |
|---|---|---|---|
| エンティティ名 | String | アカウント | 現在の Dataverse テーブル名。 |
| 属性名 | String | transactioncurrencyid | 現在の列名 |
| ReferencedEntity | String | transactioncurrency | 関連する Dataverse テーブル名 |
| ReferencedAttribute | String | transactioncurrencyid | 関連する列名 |
詳細情報: テーブル リレーションシップの概要。
OptionsetMetadata は、インポートされた Dataverse テーブルにローカル選択肢ラベルメタデータを格納します。 GlobalOptionsetMetadata は、グローバル選択ラベルメタデータを格納し、同じテーブル スキーマに加えて、テーブルと選択肢名の組み合わせである 1 つの追加列 GlobalOptionSetName に従います。
| 列名 | データの種類 | サンプル値 | Description |
|---|---|---|---|
| EntityName | String | アカウント | データバース テーブル名。 |
| オプションセット名 | String | オーナーシップコード | 列名。 |
| Option | ビッグイント | 1 | 選択項目の作成時にユーザー指定の数値ラベル。 |
| IsUserLocalizedLabel | ブール値 | いいえ | 既定では False を返します。 |
| ローカライズラベル言語コード | Bigint | 1033 | 選択ラベルの言語コード (英語 (米国) の場合は 1033、スペイン語 (スペイン) の場合は 1034 など)。 |
| ローカライズされたラベル | String | Public | 選択項目の作成時にユーザー指定のテキスト ラベル。 |
| GlobalOptionSetName（GlobalOptionSetMetadata のみ） | String | ソーシャルプロフィールコミュニティ | テーブルと選択肢の名前の組み合わせ |
Dataverse テーブルでは、choice 列にユーザー指定の数値が含まれています。これは、前述の OptionsetMetadata テーブルの Option 値と同じです。
前提条件
Azure Synapse Link for Dataverse。 この記事では、 Azure Synapse Link for Dataverse を使用して Dataverse からデータを既にエクスポートしていることを前提としています。
選択メタデータにアクセスする
- 目的の Azure Synapse Link を選択し、コマンド バーの [Azure Synapse Analytics に移動] ワークスペース を選択します。
- 左側のウィンドウで [Lake Databases ] を展開し、[ dataverse-environmentName-organizationUniqueName] を選択し、[ テーブル] を展開します。 一覧表示されているすべての選択メタデータは、分析に使用できます。
サーバーレス SQL プールで Dataverse 選択肢列を使用するため。
- データベース アイコンを右クリックし、[ 新しい SQL スクリプト>Empty スクリプト] を選択します。
- 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>)
複数のオプション セット値を使用する方法の詳細については、共通テーブル式の使用が必要です。