Accéder aux étiquettes de choix directement à partir de Azure Synapse Link for Dataverse

Microsoft Dataverse fournit des métadonnées riches qui peuvent être utilisées directement dans Power Apps. Un choix (liste de sélection) est l’un des types de colonnes les plus utilisés pouvant être inclus dans un tableau. Il définit un ensemble d’options. Lorsqu’un choix s’affiche dans un formulaire, il utilise un contrôle de liste déroulante. Vous pouvez définir un choix pour utiliser un ensemble d’options définies dans le groupe (localement) ou définies ailleurs (globalement) et pouvant être utilisées par d’autres colonnes de choix.

Pour plus d’informations sur les colonnes de choix, consultez Vue d’ensemble de la création et de la modification d’un choix global.

Après avoir créé un Azure Synapse Link, les cinq tables suivantes sont créées dans un dossier nommé OptionsetMetadata dans Azure Data Lake Storage Gen2 :

• OptionsetMetadata
• GlobalOptionsetMetadata
• StateMetadata
• StatusMetadata
• TargetMetadata

StateMetadata et StatusMetadata stockent les valeurs de choix État et Statut à récupérer. TargetMetadata stocke les métadonnées de relations de table à récupérer.

Nom de colonne	Type de données	Exemple de valeur	Description
EntityName	Chaîne	compte	Nom de la table Dataverse actuelle.
AttributeName	Chaîne	transactioncurrencyid	Nom de la colonne actuelle
ReferencedEntity	Chaîne	transactioncurrency	Nom de la table Dataverse associée
ReferencedAttribute	Chaîne	transactioncurrencyid	Nom de la colonne associée

Pour plus d’informations : Présentation des relations de table.

OptionsetMetadata stocke les métadonnées d’étiquette des choix locaux dans les tables Dataverse importées. GlobalOptionsetMetadata stocke les métadonnées d’étiquette des choix globaux et suit le même schéma de table plus une colonne supplémentaire, GlobalOptionSetName, une combinaison de nom de table et de choix.

Nom de colonne	Type de données	Exemple de valeur	Description
EntityName	Chaîne	compte	Nom de la table Dataverse.
OptionSetName	Chaîne	ownershipcode	Nom de colonne.
Option	Bigint	1	Libellé numérique spécifié par l’utilisateur lors de la création de l’élément de choix.
IsUserLocalizedLabel	Booléen	False	Renvoie False par défaut.
LocalizedLabelLanguageCode	Bigint	1033	Le code langue de l’étiquette de choix, tel que 1033 pour l’anglais (États-Unis) ou 1034 pour l’espagnol (Espagne).
LocalizedLabel	Chaîne	Publique	Libellé textuel spécifié par l’utilisateur lors de la création de l’élément de choix.
GlobalOptionSetName (GlobalOptionsetMetadata uniquement)	Chaîne	socialprofile_community	Une combinaison de nom de table et de choix

Dans les tables Dataverse, la colonne de choix contient une valeur numérique spécifiée par l’utilisateur, identique à la valeur Option dans la table OptionsetMetadata décrite ci-dessus.

Conditions préalables

Azure Synapse Link for Dataverse. Cet article suppose que vous avez déjà exporté des données Dataverse en utilisant Azure Synapse Link for Dataverse. 

Accéder aux métadonnées de choix

1. Sélectionnez le Azure Synapse Link souhaité et sélectionnez  Accéder à l’espace de travail Azure Synapse Analytics  dans la barre de commandes.  
2. Développez  Bases de données en lac dans le volet de gauche, sélectionnez dataverse-NomEnvironnement-NomUniqueOrganisation, puis développez  Tables.  Toutes les métadonnées de choix répertoriées sont disponibles pour analyse.

Pour consommer des colonnes de choix Dataverse avec un pool SQL sans serveur.

1. Cliquez avec le bouton droit sur l’icône de la base de données, puis sélectionnez Nouveau script SQL > Script vierge.
2. Appliquez un script SQL de jointure pour joindre les métadonnées de choix à votre table Dataverse et stocker la vue dans une nouvelle base de données.

Exemple de script SQL pour joindre les métadonnées de choix

Remplacez <DATABASE_NAME>,<COLUMN_NAME> et <TABLE_NAME> avec le nom de la base de données, de la colonne et de la table pour remplacer la valeur de choix numérique par une étiquette textuelle significative

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>)

Pour plus d’informations sur la consommation de plusieurs valeurs de groupe d’options, consultez Utilisation des expressions de table courantes.