Partager via

Accéder aux étiquettes de choix directement à partir d’Azure Synapse Link pour Dataverse

Microsoft Dataverse fournit des métadonnées enrichies qui peuvent être utilisées directement dans Power Apps. Un choix (liste de choix) est l’un des types de colonnes les plus utilisés qui peuvent être inclus dans une table. 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 en lui-même (localement) ou utiliser un ensemble d’options définies ailleurs (globalement), qui peuvent être utilisées par d’autres colonnes de choix.

Pour plus d’informations sur les colonnes de choix, accédez à Créer et modifier la vue d’ensemble des choix globaux.

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

  • OptionsetMetadata
  • GlobalOptionsetMetadata
  • StateMetadata
  • Statut des métadonnées
  • TargetMetadata

Tables créées dans Azure Synapse Analytics avec des colonnes de choix

StateMetadata et StatusMetadata stockent la valeur de choix d’état et d’état à récupérer. TargetMetadata stocke les métadonnées de relations de table à récupérer.

Nom de colonne Type de données Valeur d'échantillon Descriptif
Nom de l'Entité Chaîne account Nom de la table Dataverse actuelle.
Nom d'Attribut Chaîne transactioncurrencyid Nom de colonne actuel
ReferencedEntity Chaîne transactioncurrency Nom de la table Dataverse associée
ReferencedAttribute Chaîne transactioncurrencyid Nom de colonne associé

Plus d’informations : Vue d’ensemble des relations de table.

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

Nom de colonne Type de données Valeur d'échantillon Descriptif
EntityName Chaîne account Nom de la table Dataverse.
OptionSetName Chaîne code de propriété Nom de colonne.
Choix Bigint 1 Étiquette numérique spécifiée par l’utilisateur lors de la création de l’élément de choix.
IsUserLocalizedLabel Booléen Faux Retourne la valeur False par défaut.
CodeDeLangueDeLibelléLocalisé Bigint 1033 Code de langue de l’étiquette de choix, par exemple 1033 pour l’anglais (États-Unis) ou 1034 pour l’espagnol (Espagne).
LocalizedLabel Chaîne Publique Étiquette de texte spécifiée par l’utilisateur lors de la création de l’élément de choix. 
GlobalOptionSetName (GlobalOptionsetMetadata uniquement) Chaîne socialprofile_community combinaison entre nom de table et nom de choix

Schéma de table OptionsetMetadata et GlobalOptionsetMetadata.

Dans les tables Dataverse, la colonne de choix contient une valeur numérique spécifiée par l’utilisateur, qui est la même que la valeur d’option dans la table OptionsetMetadata décrite ci-dessus.

Prérequis

Azure Synapse Link pour Dataverse. Cet article part du principe que vous avez déjà exporté des données à partir de Dataverse à l’aide d’Azure Synapse Link pour Dataverse. 

Accéder aux métadonnées de choix

  1. Sélectionnez le Azure Synapse Link souhaité, puis choisissez Accédez à l’espace de travail Azure Synapse Analytics dans la barre de commandes.  
  2. Développez Lake Databases dans le volet gauche, sélectionnez dataverse-environmentName-organizationUniqueName, puis développez Tables.  Toutes les métadonnées de choix répertoriées sont disponibles pour l’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>vide.
  2. Appliquez un script SQL de jointure pour joindre les métadonnées de choix à votre table Dataverse et stockez la vue dans une nouvelle base de données.

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

Remplacez <DATABASE_NAME,COLUMN_NAME><> et <TABLE_NAME> par 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 de texte explicite

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.

  • Last updated on