サーバーレス SQL プールで Dataverse の選択肢 (オプションセット) にアクセスする

[アーティクル]
03/09/2022

Microsoft Dataverse 選択肢を使用する列の場合、選択値は、編集中の一貫性を維持するために、テキストラベルではなく整数ラベルとして書き込まれます。「整数からテキスト」のラベルマッピングは、Microsoft.Athena.TrickleFeedService/table-EntityMetadata.json ファイルに格納されています。この記事では、サーバーレス SQL プールを使用して、整数からテキストへのラベルマッピングにアクセスする方法を紹介します。

オプションセットにアクセスする。

注意

Azure Synapse Link for Microsoft Dataverse は以前は、Data Lake へのエクスポートと呼ばれていました。このサービスは、2021 年 5 月より名称が変更され、Azure Synapse Analytics だけでなく、Azure Data Lake へのデータのエクスポートも継続されます。

前提条件

ここでは、Azure Synapse Link for Dataverse サービスを利用した後、サーバーレス SQL プールで Dataverse データを消費するために必要となる前提条件について説明します。

Azure Synapse Link for Dataverse: このガイドでは、すでにAzure Synapse Link for Dataverse と Azure Synapse Analytics のワークスペースを使用して Dataverse からデータをエクスポートしていることを前提にしています。
ストレージアカウントのアクセス。 ストレージアカウントには、次のいずれかのロールが付与されている必要があります: ストレージ BLOB データ閲覧者、ストレージ BLOB データ共同作成者、またはストレージ BLOB データ所有者。

サーバーレス SQL プールで Dataverse の選択肢を使用する

Azure Synapse Analytics ワークスペースに移動します。
左側のサイドパネルから開発を選択し、+ > SQL スクリプト を選択します。
以下の SQL クエリを貼り付けて、<STORAGE_ACCOUNT> をストレージアカウント名、<CONTAINER_NAME> をコンテナ名に置き換えます。

    SELECT [EntityName], [OptionSetName], [Option], [IsUserLocalizedLabel], [LocalizedLabelLanguageCode], [LocalizedLabel]
    FROM OPENROWSET (
        BULK 'https://<STORAGE_ACCOUNT>.dfs.core.windows.net/<CONTAINER_NAME>/Microsoft.Athena.TrickleFeedService/*-EntityMetadata.json', 
        FORMAT = 'csv',
        FIELDTERMINATOR ='0x0b',
        FIELDQUOTE = '0x0b',
        ROWTERMINATOR = '0x0b'
    ) WITH (doc nvarchar(max)) AS rows
    CROSS APPLY OPENJSON(doc, '$.OptionSetMetadata')
    WITH (
            [EntityName] nvarchar(4000) '$.EntityName',
            [OptionSetName] nvarchar(4000) '$.OptionSetName',
            [Option] int '$.Option',
            [IsUserLocalizedLabel] nvarchar(4000) '$.IsUserLocalizedLabel',
            [LocalizedLabelLanguageCode] int '$.LocalizedLabelLanguageCode',
            [LocalizedLabel] nvarchar(4000) '$.LocalizedLabel'
    )

クエリを実行します。 Dataverse の選択肢を含むテーブルが表示されます。
Dataverse の選択肢と Dataverse のテーブルを結合し、[database-name].[schema-name].[table-name] という 3 つの部分からなる命名規則を使って、ビューを新しいデータベースに格納します。

サーバーレス SQL プールで Dataverse の選択肢 (オプションセット) にアクセスする

前提条件

サーバーレス SQL プールで Dataverse の選択肢を使用する

関連項目

フィードバック