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
- Sélectionnez le Azure Synapse Link souhaité et sélectionnez Accéder à l’espace de travail Azure Synapse Analytics dans la barre de commandes.
- 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.
- Cliquez avec le bouton droit sur l’icône de la base de données, puis sélectionnez Nouveau script SQL > Script vierge.
- 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.