--- sourceDocument: Australie Workflow Data Fabric sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/integrate-applications Release : - australia ft:locale : - fr-FR ft:publication_title : - Australie Workflow Data Fabric ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # Collecteur de métadonnées PowerBI # Collecteur de métadonnées PowerBI {#ariaid-title1} * Rversion finale: Australia * * Mis à jour 12 mars 2026 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 23 minutes de lecture Le collecteur de métadonnées PowerBI fournit un accès en lecture seule aux métadonnées à partir d'un compte PowerBI. [Power BI](https://learn.microsoft.com/en-us/power-bi/fundamentals/power-bi-overview) est un ensemble de services logiciels, d'applications et de connecteurs qui fonctionnent ensemble pour transformer des sources de données non liées en aperçus cohérents, visuellement immersifs et interactifs. Les sources de données peuvent inclure des feuilles de calcul Excel, des entrepôts de données basés sur le cloud ou des entrepôts de données hybrides sur site. Power BI vous permet de vous connecter à des sources de données, de visualiser et de découvrir des informations importantes, et de partager des informations au sein de l'organisation. Le collecteur Power BI collecte les métadonnées des espaces de travail de service Power BI. Utilisez les métadonnées collectées pour découvrir des rapports et des tableaux de bord dans les espaces de travail et effectuez une analyse d'impact pour comprendre comment les changements apportés aux sources de données en amont affectent les rapports Power BI. ## Version prise en charge {#powerbi-metadata-collector__section_jx5_kf5_m3c} Le module de collection prend en charge Power BI Cloud API v 1.0. ## Authentification prise en charge {#powerbi-metadata-collector__section_ogq_lf5_m3c} Power BI prend en charge deux méthodes d'authentification : * Principal du service * Utilisateur et mot de passe {#powerbi-metadata-collector__ul_pjh_4f5_m3c}Le collecteur collecte les métadonnées de toutes les applications et espaces de travail Power BI auxquels le compte authentifié a accès. ## Métadonnées cataloguées {#powerbi-metadata-collector__section_cbx_tnc_l3c} Le collecteur Power BI répertorie les informations suivantes : {#powerbi-metadata-collector__table_jvn_5nc_l3c__entry__2} | Objet | Informations collectées | |-|-| | Espaces de travail | Titre, description | | Applications | Titre, description | | Mesures Power BI | Titre, Description, Est masqué, Expression | | Rapports | Titre, Type de rapports, URL externe, URL incorporée, Image d'aperçu (non pris en charge pour les types de rapports paginés), Date de création, Dernière modification, Créé par, Dernière modification par, Descriptions | | Pages du rapport | Titre Remarque : les pages de rapport dans les applications ne peuvent pas être cataloguées lors de l'utilisation de l'authentification principale du service en raison de restrictions dans les API Power BI. | | Tableaux de bord | Titre, URL externe, URL incorporée | | Vignettes de tableaux de bord | Titre, URL incorporée | | Sources de données | Titre, type de source de données, détails de connexion (type et chemin) | | Modèle sémantique | Titre, URL externe, Description, Date de création, Créé par, Actualiser le calendrier | | Flux de données | Titre, Dernière modification, Description, Créé par, Actualiser le calendrier | | Tables Power BI (modèle sémantique et flux de données) | Titre, Est masqué, Sont des données saisies, Description, Expression source | | Table calculée Power BI | Titre, Est masqué, Sont des données saisies, Description, Expression source | | Colonnes Power BI | Titre, Descriptions, Type de données, Type de colonne, Est masqué, Expression | | Fichier tabulaire | Chemin d'accès au fichier, Nom de fichier | | Répertoire de fichiers | Chemin d'accès au répertoire | | Base de données | Titre, Type, Identificateur, Serveur, Port | | Schéma de base de données | Titre | | Table de base de données | Titre | | Colonne de base de données | Titre | | Table | Titre, description | | Colonne | Titre, type | | Groupe de calcul | Titre, description | | Élément de calcul | Titre, Description, Expression | [Tableau 1. Métadonnées collectées] {#powerbi-metadata-collector__table_jvn_5nc_l3c} ## Relations entre les objets {#powerbi-metadata-collector__section_qv4_c4c_l3c} Les pages de catalogue affichent les relations entre les types de ressources de données suivants : {#powerbi-metadata-collector__table_fbw_d4c_l3c__entry__2} | Page Actifs de données | Relation | |-|-| | Application | Rapport, tableau de bord, espace de travail | | Colonne Power BI | Power BI Table | | Source de données | Modèle sémantique, flux de données, source de données tabulaires (base de données, fichier tabulaire) | | Mosaïque | Tableau de bord, Rapport, Modèle sémantique | | Tableau de bord | Mosaïque, espace de travail | | Vignette du tableau de bord | Modèle sémantique associé | | Modèle sémantique | Vignette du tableau de bord, rapport | | Rapport | Mosaïque, espace de travail, pages de rapport (ne s'applique pas aux types de rapports paginés), modèle sémantique (ne s'applique pas aux types de rapports paginés), rapport Remarque : Dans Power BI, les rapports d'application et leurs rapports d'espace de travail associés sont deux rapports distincts avec des ID de rapport uniques. Le collecteur répertorie la relation entre eux. | | Pages du rapport | Rapport (ne s'applique pas aux types de rapports paginés) | | Modèle sémantique | Mosaïque, Espace de travail, Rapport, Table, Source de données, Modèle sémantique, Flux de données | | Espace de travail | Rapport, Modèle sémantique, Flux de données, Tableau de bord, Application | | Flux de données | Espace de travail, Table, Source de données, Flux de données | | Power BI Table | Modèle sémantique, flux de données, colonne Power BI, mesure Power BI | | Mesure Power BI | Power BI Table | | Source de données tabulaires (base de données, fichier tabulaire) | Source de données | | Groupe de calcul | Power BI Table | | Élément de calcul | Groupe de calcul | [Tableau 2. Relations entre les objets catalogués] {#powerbi-metadata-collector__table_fbw_d4c_l3c} ## Traçabilité pour PowerBI {#powerbi-metadata-collector__section_sjn_j4c_l3c} Les informations de traçabilité suivantes sont collectées par le collecteur Power BI. Le collecteur utilise [les API de l'analyseur Power BI](https://docs.data.world/en/197965-preparing-to-run-the-power-bi-gov-collector.html#UUID-54824f09-f93b-9459-1077-457716965021_section-idm682803229937714) pour établir la traçabilité avec les tables et colonnes sources. Assurez-vous de vous familiariser avec les [limites des API de scanner](https://learn.microsoft.com/en-us/fabric/governance/metadata-scanning-run#considerations-and-limitations) {#powerbi-metadata-collector__table_igt_l4c_l3c__entry__2} | Objet | Traçabilité disponible | |-|-| | Vignette du tableau de bord | Modèle sémantique associé | | Modèle sémantique | Flux de données associé, modèle sémantique | | Flux de données | Flux de données | | Colonne Power BI | Colonnes associées à partir desquelles la colonne tire ses données ou calcule ses valeurs. Remarque : La traçabilité peut être récupérée à partir d'expressions Power BI qui utilisent des paramètres à la place des noms de serveur, de schéma, de table ou de base de données. Les relations de traçabilité et de catalogue au niveau de la table et de la colonne ne sont pas disponibles entre les tables ou les colonnes et les rapports via l'API Power BI. | | Table Power BI | Tables associées à partir desquelles la table tire ses données Remarque : Remarque : Le collecteur utilise les expressions Power BI renvoyées par les API pour analyser la traçabilité aux colonnes/tables sources. | | Table calculée Power BI | Tables et colonnes Power BI d'où la table calculée tire ses valeurs. | | Mesure Power BI | Colonnes associées à partir desquelles la mesure s'approvisionne en données | [Tableau 3. Disponibilité de traçabilité par objet] {#powerbi-metadata-collector__table_igt_l4c_l3c} La table suivante répertorie les opérations et transformations de table prises en charge et non prises en charge. Cela inclut les expressions sources, les colonnes calculées et les expressions de mesure utilisées dans la collecte des métadonnées de traçabilité. Les opérations non répertoriées ne sont pas récoltées. {#powerbi-metadata-collector__table_llb_dc5_m3c__entry__2} | Catégorie | Catégorie | |-|-| | Expressions paramétrées prises en charge | Le collecteur analyse les expressions source qui utilisent des paramètres à la place des valeurs suivantes : source complète, serveur ou hôte, entrepôt, nom de base de données, nom de schéma, nom de table et expressions SQL. | | [Fonctions de données prises en charge](https://learn.microsoft.com/en-us/powerquery-m/accessing-data-functions) | Csv.Document, Excel.Workbook, File.Contents, Folder.Contents, Folder.Files, Json.Document, Odbc.DataSource, Odbc.InferOptions, Odbc.Query, Xml.Document, Web.Contents, Web.Headers, Web.BrowserContents, AmazonRedshift.Database, Sql.Database, Sql.Databases, Snowflake.Databases, PostgreSQL.Database, Databricks.Catalogs, Oracle.Database, Denodo.Contents, Databricks.Query, DatabricksMultiCloud.Catalogs, AnalysisServices.Database, GoogleBigQuery.Database | | [Fonctions de table prises en charge](https://learn.microsoft.com/en-us/powerquery-m/table-functions) | Table.AjouterColonne, Table.AjouterIndexColonne, Table.RenommerColonnes, Table.JointureImmature, Table.ExpandTableColonne, Table.DiviserColonne, Table.Colonne Dupliquée, Table.CombineColumns | | Opérations de table non prises en charge | Table.Pivot, Table.PromoteHeaders, Table.DemoteHeaders, Table.PrefixColumns, Table.TransformColumnNames, Table.Unpivot, Table.UnpivotOtherColumns, Table.AddFuzzyClusterColumn, Table.AddJoinColumn, Table.AggregateTableColumn, Table.Combine, Table.CombineColumnsToRecord, Table.ExpandRecordColumn, Table.Join, Table.Transpose | | Fonctions de flux de données prises en charge | PowerPlatform.Flux de données, PowerBI.Flux de données | | [Fonctions de valeur prises en charge](https://learn.microsoft.com/en-us/powerquery-m/value-functions) | Valeur.RequêteNative | | Colonnes calculées prises en charge | Traçabilité à partir des expressions de colonnes calculées contenant des colonnes avec et sans références de table, des colonnes ou des tables avec des caractères alphanumériques, des espaces, des tirets et des traits de soulignement sont pris en charge | | Mesures prises en charge | Traçabilité à partir des expressions de mesure contenant des colonnes ou des tables avec des caractères alphanumériques, des espaces, des traits d'union, des traits de soulignement et des guillemets environnants sont pris en charge | [Tableau 4. Transformations et expressions prises en charge pour la collecte des métadonnées de traçabilité] {#powerbi-metadata-collector__table_llb_dc5_m3c} ## Préparer l'exécution du collecteur PowerBI {#ariaid-title2} Configurez l'inscription, l'authentification et les autorisations de l'application Azure avant d'exécuter le module de collection. ### Avant de commencer Rôle requis : admin Important : Un administrateur Power BI est nécessaire pour activer les paramètres dans le portail d'administration Power BI. ### Pourquoi et quand exécuter cette tâche Le collecteur utilise l'inscription de l'application Azure et prend en charge deux méthodes d'authentification : principal du service ou nom d'utilisateur et mot de passe. Vous devez enregistrer une application, configurer l'authentification, activer l'analyse des métadonnées et récupérer l'ID de locataire. Vous pouvez également configurer la collecte d'images de rapport et le mappage de traçabilité. ### Procédure 1. Enregistrez une application dans Azure et créez les informations d'identification du client. Consultez [Inscrire l'application Power BI](https://servicenow-prod.fluidtopics.net/P9BAoPF9hF6tAfW68j8qZA#prepare-to-run-powerbi-collector-register-app "Enregistrez une application dans Azure et créez les informations d’identification du client pour l’authentification du collecteur Power BI."). 2. Configurez l'authentification en fonction de votre méthode préférée. * Pour l'authentification du principal du service, reportez-vous à la section [Configurer l'authentification principale du service Power BI](https://servicenow-prod.fluidtopics.net/P9BAoPF9hF6tAfW68j8qZA#prep-to-run-powerbi-collector-service-principal-auth "Configurez l’authentification principale du service pour activer la collecte de métadonnées Power BI."). * Pour l'authentification par nom d'utilisateur et mot de passe, reportez-vous à la section [Configurer l'authentification par nom d'utilisateur et mot de passe Power BI](https://servicenow-prod.fluidtopics.net/P9BAoPF9hF6tAfW68j8qZA#prep-to-run-powerbi-collector-username-auth "Configurez des autorisations d’API pour l’authentification par nom d’utilisateur et mot de passe afin d’activer la collecte de métadonnées Power BI."). 3. Activez l'analyse des métadonnées pour accéder à des informations détaillées sur les sources de données. Consultez [Configurer l'analyse des métadonnées Power BI](https://servicenow-prod.fluidtopics.net/P9BAoPF9hF6tAfW68j8qZA#prep-to-run-powerbi-collector-metadata-scan "Activez l’analyse des métadonnées pour accéder à des informations détaillées sur la source de données, y compris les tables et les colonnes."). 4. Obtenez l'ID de locataire Power BI. Consultez [Obtenir l'ID de locataire Power BI](https://servicenow-prod.fluidtopics.net/P9BAoPF9hF6tAfW68j8qZA#prep-to-run-powerbi-collector-get-tenant-id "Récupérez l’ID de locataire à partir de l’application Power BI."). 5. **Facultatif :** Configurez la collecte d'images de rapports pour collecter des images d'aperçu à partir des rapports Power BI. Consultez [Configurer la collecte d'images de rapport Power BI](https://servicenow-prod.fluidtopics.net/P9BAoPF9hF6tAfW68j8qZA#prep-to-run-powerbi-collector-report-image-harvest "Activez la collecte d’images de rapports pour collecter des images d’aperçu à partir des rapports Power BI."). 6. **Facultatif :** Configurez le mappage de traçabilité pour les connexions ODBC, les alias de serveur ou les instructions SQL personnalisées. Voir [Configurer le mappage de traçabilité Power BI](https://servicenow-prod.fluidtopics.net/P9BAoPF9hF6tAfW68j8qZA#prep-to-run-powerbi-collector-lineage-mapping "Créez un fichier YAML pour mapper des sources de données pour la collecte de lignées."). ### Inscrire l'application Power BI {#ariaid-title3} Enregistrez une application dans Azure et créez les informations d'identification du client pour l'authentification du collecteur Power BI. #### Avant de commencer Rôle requis : admin Vous devez disposer des autorisations nécessaires pour enregistrer des applications dans Azure Active Directory. #### Pourquoi et quand exécuter cette tâche Enregistrez une application dans Azure pour obtenir l'ID client et le secret client nécessaires à l'authentification Power BI Collector. #### Procédure 1. Enregistrez une nouvelle application dans Azure. 1. Accédez au [portail Azure](https://portal.azure.com). 2. Sélectionnez les inscriptions d'application à partir des services Azure. 3. Sélectionnez Nouvelle inscription. 4. Saisissez les informations d'inscription. * Nom de l'application : DataDotWorldPowerBIApplication * Types de compte pris en charge : comptes dans ce répertoire organisationnel uniquement 5. Sélectionnez S'inscrire pour terminer l'inscription. 2. Créez un secret client. 1. Sur la page de l'application, sélectionnez Certificats et secrets. 2. Sélectionnez Nouveau secret client. 3. Ajoutez une description pour le secret. 4. Sélectionnez la date d'expiration souhaitée. 5. Sélectionnez Ajouter. 6. Copiez la valeur secrète. Enregistrez cette valeur en toute sécurité. Vous l'utiliserez lors de la configuration du collecteur Power BI. 3. Obtenez l'ID client. 1. Sélectionnez l'onglet Vue d'ensemble dans la barre latérale gauche de la page d'application. 2. Copiez l'ID client depuis la section Essentials. Enregistrez cette valeur. Vous l'utiliserez lors de la configuration du collecteur Power BI. ### Configurer l'authentification principale du service Power BI {#ariaid-title4} Configurez l'authentification principale du service pour activer la collecte de métadonnées Power BI. #### Avant de commencer Rôle requis : admin Vous devez être administrateur Power BI pour activer les paramètres principal du service. Important : Lors de l'exécution sous un principal de service, il ne doit y avoir aucun ensemble d'autorisations Power BI administrateur-consentement-requis défini sur votre application. Pour plus d'informations, consultez la [documentation Microsoft](https://learn.microsoft.com/en-us/power-bi/enterprise/service-premium-service-principal). #### Pourquoi et quand exécuter cette tâche Lors de l'authentification principale du service, le collecteur collecte tous les objets, à l'exception des espaces de travail personnels, des espaces de travail utilisateur et des pages de rapport. Pour collecter toutes les applications et tous les espaces de travail du locataire, activez Cataloguer tous les espaces de travail et applications du locataire. Pour inclure des espaces de travail personnels et utilisateur, activez le contenu du catalogue de Mon espace de travail de l'utilisateur. Remarque : Pour prélever des pages de rapport, accordez au principal de service l'accès à chaque espace de travail. L'API d'administration n'a pas de point de terminaison pour les pages de rapport. #### Procédure 1. Connectez-vous à Power BI à l'aide d'un compte administrateur Power BI. 2. Accédez à la ParamètresPortail d'administration. 3. Activer l'accès à l'API principale du service. 1. Sous Paramètres du développeur, localisez Les principaux de service peuvent utiliser les API Fabric. 2. Activez le paramètre. 3. Sélectionnez si le paramètre s'applique à l'ensemble de l'organisation ou à des groupes de sécurité spécifiques. Si vous utilisez des groupes de sécurité spécifiques, vérifiez que le groupe inclut le principal du service. 4. Sélectionnez Appliquer pour enregistrer les changements. 4. **Facultatif :** Ajoutez le principal de service aux espaces de travail pour l'accès à la page de flux de données et de rapport. Les flux de données exigent que le principal de service dispose au moins d'un accès contributeur à l'espace de travail. Pour les pages de rapport, le principal de service a également besoin d'un accès à l'espace de travail, car l'API administrateur ne fournit pas de point de terminaison pour les pages de rapport. 1. Ouvrez l'espace de travail. 2. Sélectionnez Gérer l'accès. 3. Recherchez le principal de service ou le groupe de sécurité auquel il appartient. 4. Sélectionnez le niveau d'accès approprié. Si des flux de données sont utilisés, sélectionnez au moins Accès contributeur. Sinon, sélectionnez Visionneuse. 5. Sélectionnez Ajouter. ### Configurer l'authentification par nom d'utilisateur et mot de passe Power BI {#ariaid-title5} Configurez des autorisations d'API pour l'authentification par nom d'utilisateur et mot de passe afin d'activer la collecte de métadonnées Power BI. #### Avant de commencer Rôle requis : admin Vous devez disposer des autorisations pour configurer les autorisations d'API dans Azure Active Directory. Remarque : Seuls les administrateurs du locataire peuvent accorder le consentement administrateur. #### Pourquoi et quand exécuter cette tâche Lors de l'authentification utilisateur, le collecteur collecte tous les objets, à l'exception des espaces de travail personnels, des espaces de travail utilisateur et des pages de rapport. Pour collecter toutes les applications et tous les espaces de travail du locataire, activez Cataloguer tous les espaces de travail et applications du locataire. Pour inclure des espaces de travail personnels et utilisateur, activez le contenu du catalogue de Mon espace de travail de l'utilisateur. Pour recueillir des pages de rapport, accordez à l'utilisateur l'accès à chaque espace de travail. L'API d'administration n'a pas de point de terminaison pour les pages de rapport. Remarque : Cataloguer tous les espaces de travail et applications du locataire nécessite que l'utilisateur dispose des droits d'administrateur général Microsoft 365 ou d'administrateur de service Power BI pour l'analyse des métadonnées. Pour plus d'informations, consultez la [documentation Power BI](https://learn.microsoft.com/en-us/power-bi/enterprise/service-admin-metadata-scanning). #### Procédure 1. Accédez au portail Azure et ouvrez l'inscription de l'application. 2. Sélectionnez les autorisations d'API. 3. Ajoutez des autorisations Microsoft Graph. 1. Sélectionnez Ajouter une autorisation. 2. Recherchez et sélectionnez Microsoft Graph. 3. Ajoutez les autorisations suivantes. * Autorisation de l'application : Application.Read.All * Autorisation déléguée : User.Read (affectée par défaut) 4. Ajoutez des autorisations de service Power BI. 1. Sélectionnez Ajouter une autorisation. 2. Recherchez et sélectionnez le service Power BI. 3. Sélectionnez les autorisations déléguées. 4. Ajoutez les autorisations suivantes. * App.Read.All * Tableau de bord.Lire.Tout * Flux de données.Lire.Tout * Ensemble de données.Lire.Tout * Rapport.Lire.Tout * Locataire.Lecture.Tout * Espace de travail.Lire.Tout 5. Sélectionnez le bouton Accorder le consentement de l'administrateur situé à côté du bouton Ajouter une autorisation . Cette autorisation permet au module de collection de s'exécuter sans vous demander l'autorisation à chaque exécution. ### Configurer l'analyse des métadonnées Power BI {#ariaid-title6} Activez l'analyse des métadonnées pour accéder à des informations détaillées sur la source de données, y compris les tables et les colonnes. #### Avant de commencer Rôle requis : admin Vous devez être administrateur Power BI pour activer les paramètres d'analyse des métadonnées. #### Pourquoi et quand exécuter cette tâche [L'analyse des métadonnées](https://learn.microsoft.com/en-us/fabric/governance/metadata-scanning-overview) permet d'accéder à des informations détaillées sur les sources de données, telles que les tables et les colonnes, via les API d'administration en lecture seule Power BI. Le collecteur utilise les API de l'analyseur Power BI pour établir la traçabilité avec les tables et colonnes sources. Examinez les [limitations des API du scanner](https://learn.microsoft.com/en-us/power-bi/enterprise/service-admin-metadata-scanning) avant de configurer le collecteur. #### Procédure Activez l'analyse des métadonnées en fonction de votre méthode d'authentification. * Pour l'authentification principale du service : 1. Suivez la [documentation Power BI](https://learn.microsoft.com/en-us/power-bi/enterprise/service-premium-service-principal) pour activer l'authentification principale du service pour les API en lecture seule Power BI 2. Activez les paramètres de locataire améliorés suivants pour l'analyse des métadonnées : * Améliorez les réponses des API d'administration avec des métadonnées détaillées * Améliorez les réponses des API d'administration avec des expressions DAX et d'application composite * Pour l'authentification par nom d'utilisateur et mot de passe, activez les paramètres de locataire améliorés suivants pour l'analyse des métadonnées : Important : L'utilisateur doit disposer des droits d'administrateur (administrateur global Microsoft 365 ou administrateur de service Power BI) pour utiliser l'analyse des métadonnées. Pour plus d'informations, consultez la [documentation Power BI](https://learn.microsoft.com/en-us/power-bi/enterprise/service-admin-metadata-scanning). * Améliorez les réponses des API d'administration avec des métadonnées détaillées * Améliorez les réponses des API d'administration avec des expressions DAX et d'application composite ### Obtenir l'ID de locataire Power BI {#ariaid-title7} Récupérez l'ID de locataire à partir de l'application Power BI. #### Avant de commencer Rôle requis : admin #### Pourquoi et quand exécuter cette tâche L'ID de locataire est requis lors de la configuration du collecteur Power BI. Récupérez cette valeur à partir de l'application Power BI. #### Procédure 1. Dans l'application Power BI, sélectionnez l'icône du point d'interrogation. 2. Sélectionnez À propos de Power BI. 3. Copiez l'ID de locataire à partir de la fin de l'URL de locataire. Enregistrez cette valeur. Vous l'utiliserez lors de la configuration du collecteur Power BI. ### Configurer la collecte d'images de rapport Power BI {#ariaid-title8} Activez la collecte d'images de rapports pour collecter des images d'aperçu à partir des rapports Power BI. #### Avant de commencer Rôle requis : admin Remarque : La collecte d'images de rapports n'est pas prise en charge pour les applications Power BI. #### Pourquoi et quand exécuter cette tâche Activez la collecte d'images de rapports pour collecter des images d'aperçu à partir des rapports Power BI en vue de les afficher dans le catalogue de données. #### Procédure 1. Activez le paramètre d'exportation dans le portail administrateur Power BI. 1. Connectez-vous à Power BI à l'aide d'un compte administrateur Power BI. 2. Accédez à la ParamètresPortail d'administration. 3. Localisez et activez le paramètre Exporter les rapports sous forme de fichiers image dans les [paramètres Admin](https://learn.microsoft.com/en-us/power-bi/developer/embedded/export-to#using-the-api). 2. Vérifiez la capacité de l'espace de travail. Vérifiez que les rapports à exporter se trouvent dans un espace de travail avec une capacité Premium, Incorporé ou Fabric. Pour plus d'informations, consultez la [documentation Power BI](https://learn.microsoft.com/en-us/power-bi/enterprise/service-premium-what-is). ### Configurer le mappage de traçabilité Power BI {#ariaid-title9} Créez un fichier YAML pour mapper des sources de données pour la collecte de lignées. #### Avant de commencer Rôle requis : admin #### Pourquoi et quand exécuter cette tâche Il s'agit d'une tâche facultative pour la collecte des informations de traçabilité. Créez un fichier YAML et transmettez-le à l'aide de l'option de fichier de mappage de nom de la source de données lors de l'exécution du collecteur. Configurez un fichier YAML dans les scénarios suivants : {#prep-to-run-powerbi-collector-lineage-mapping__table_scenarios__entry__3} | Scénario | Détails | Action | |-|-|-| | Connexions ODBC dans Power BI | Vous disposez d'une source de données dans Power BI qui utilise une connexion ODBC. Dans ces cas, Power BI ne fournit pas le type d'hôte ou de base de données de la source | Dans le fichier YAML, mappez le DSN à un hôte et à un type de base de données spécifiques. Si le nom de la base de données est manquant dans la source de données Power BI, ajoutez l'option defaultDatabaseName à la source de données dans le fichier YAML | | Alias de noms de serveurs multiples | Vous avez plusieurs noms de serveur (alias) pour la même instance de base de données (hôte) et le collecteur de base de données utilise un alias différent de celui défini dans la connexion Power BI | Utilisez le fichier YAML pour mapper l'hôte de base de données aux alias spécifiés par l'utilisateur | | Instructions SQL personnalisées | Les instructions SQL personnalisées sont utilisées dans les définitions de sources de tables Power BI. Le collecteur Power BI prend actuellement en charge la connexion aux types de bases de données suivants pour résoudre la traçabilité à partir d'instructions SQL : Snowflake, SQL Server, PostgreSQL, Redshift, Oracle, Databricks, Denodo, BigQuery. La résolution de traçabilité pour les sources de table utilisant des instructions SQL prend uniquement en charge le SQL consistant en une seule instruction SELECT | Configurez les bases de données spécifiées dans des instructions SQL personnalisées en incluant datasourceKey, hôte et informations d'identification sécurisées à l'aide de variables environnementales | [Tableau 5. Scénarios de mappage de traçabilité] {#prep-to-run-powerbi-collector-lineage-mapping__table_scenarios} Remarque : Vous pouvez utiliser des variables d'environnement dans le fichier pour les informations sensibles telles que les mots de passe. #### Procédure 1. Créez un fichier YAML nommé datasources.yml. 2. Configurez le fichier YAML en fonction de votre scénario. * Pour les alias de nom de serveur multiples : Ajoutez les éléments suivants pour mapper un alias d'hôte : datasources: - datasourceKey: "" host: Par exemple, si la source de votre table Power BI est : let Source = Snowflake.Database("host-alias.snowflakecomputing.com", "KOS_TEST"), PowerBiTest_Test_Table = Source{[Schema="POWERBI_TEST",Item="TEST_TABLE"]}[Data] in PowerBiTest_Test_Table La datasourceKey sera alors host-alias.snowflakecomputing.com. Votre fichier datasources.yml ressemblera à : datasources: - datasourceKey: host-alias.snowflakecomputing.com host: host-actual.snowflakecomputing.com * Pour les instructions SQL personnalisées : Ajoutez ce qui suit pour les bases de données spécifiées dans les instructions SQL personnalisées. Les variables environnementales sont prises en charge : datasources: - datasourceKey: "" OR - name: host: databaseUsername: # recommend setting up env variable databasePassword: # recommend setting up env variable Utilisez l'option suivante pour spécifier les bases de données auxquelles s'applique une configuration de source de données. Si ce n'est pas fourni, il est supposé que les paramètres de la source de données s'appliquent à toutes les bases de données sur l'hôte donné : applicableDatabases: - Par exemple : datasources: - datasourceKey: "example.cpcnqsn422gx.us-east-1.rds.amazonaws.com, 1433" host: example.cpcnqsn422gx.us-east-1.rds.amazonaws.com databaseUsername: ${DB_USERNAME} databasePassword: ${DB_PASSWORD} applicableDatabases: - 8bank_database * Pour les connexions ODBC : Mappez le DSN à un hôte et à un type de base de données spécifiques. Pour les connexions ODBC, répertoriez les sources de données avec leur type d'hôte et de base de données correspondants. Si les connexions ODBC utilisent Odbc.Query, spécifiez le nom d'utilisateur et le mot de passe. Si les connexions ODBC spécifient le nom de la base de données, incluez defaultDatabaseName : datasources: - name: "Name-for-datasource" host: databaseType: databaseUsername: # optional databasePassword: # optional defaultDatabaseName: # optional La liste des databaseTypes possibles est : postgres, redshift, bigquery, oracle, mysql, netezza, snowflake, sqlanywhere, sqlserver, databricks, denodo. Les types ne sont pas sensibles à la casse, mais doivent être un seul mot sans espace. Par exemple : datasources: - name: "SQL Server DSN Production" databaseType: sqlserver host: 8bank-sqlserver.cpetgx.us-east-1.rds.amazonaws.com 3. **Facultatif :** Ajoutez des options de configuration spécifiques à la base de données si nécessaire. Options des propriétés JDBC : {#prep-to-run-powerbi-collector-lineage-mapping__table_jdbc__entry__2} | Option | Description | |-|-| | jdbcProperties | Plusieurs propriétés JDBC peuvent être spécifiées à l'aide d'une liste YAML. Le format attendu est jdbcProperties : clé=valeur Par exemple : jdbcProperties : encrypt=true Pour des valeurs multiples : jdbcProperties: - encrypt=true - readOnly=true | [Tableau 6. Propriétés JDBC] {#prep-to-run-powerbi-collector-lineage-mapping__table_jdbc} Options d'informations d'identification de la base de données Snowflake : {#prep-to-run-powerbi-collector-lineage-mapping__table_snowflake__entry__2} | Option | Description | |-|-| | databaseUsername : ${DB_USERNAME} | Requis si des requêtes SQL personnalisées sont utilisées dans les sources de base de données Power BI | | databasePassword : ${DB_PASSWORD} | Requis si des requêtes SQL sont utilisées et si une clé privée n'est pas utilisée pour l'authentification dans Snowflake | | snowflakePrivateKeyFile : privateKeyFile | Requis si des requêtes SQL sont utilisées et si une clé privée est utilisée pour l'authentification dans Snowflake | | snowflakePrivateKeyFilePassword : ${privateKeyFilePassword} | Requis si des requêtes SQL sont utilisées et si une clé privée est utilisée pour l'authentification dans Snowflake | | snowflakeRole : rôle | Requis si des requêtes SQL sont utilisées | | flocon de neigeEntrepôt : entrepôt | Utiliser pour remplacer les entrepôts utilisés dans les expressions Power BI dans la connexion de base de données | [Tableau 7. Options de flocon de neige] {#prep-to-run-powerbi-collector-lineage-mapping__table_snowflake} Options d'informations d'identification de la base de données Databricks : {#prep-to-run-powerbi-collector-lineage-mapping__table_databricks__entry__2} | Option | Description | |-|-| | databricksHttpPath | Requis si la base de données source est Databricks | [Tableau 8. Options de Databricks] {#prep-to-run-powerbi-collector-lineage-mapping__table_databricks} Options de base de données autonome Oracle : {#prep-to-run-powerbi-collector-lineage-mapping__table_oracle__entry__2} | Option | Description | |-|-| | oracleAutonomousDbConnectionString | Requis si la source est une base de données autonome Oracle. La chaîne de connexion doit être au format suivant : jdbc:oracle:thin::/, jdbc:oracle:thin:@(address=(protocol=tcps)(port=)(host:)) (connect_data=(service_name=)) (security=(ssl_server_dn_match=yes)), or jdbc:oracle:thin:@alias_name?TNS_ADMIN=/path/to/wallet | [Tableau 9. Options de base de données autonome Oracle] {#prep-to-run-powerbi-collector-lineage-mapping__table_oracle} Options BigQuery : {#prep-to-run-powerbi-collector-lineage-mapping__table_bigquery__entry__2} | Option | Description | |-|-| | projet | Requis si la source est une table BigQuery | | bigQueryCredentialJsonString | Requis pour fournir des informations d'identification BigQuery | [Tableau 10. Options BigQuery] {#prep-to-run-powerbi-collector-lineage-mapping__table_bigquery} Exemple pour la base de données BigQuery : datasources: - project: "project-name" databaseType: bigquery bigQueryCredentialJsonString: '{"key": "value","key": "value"}' 4. Enregistrez le fichier datasources.yml. 5. Transmettez le fichier YAML au collecteur à l'aide du paramètre --datasource-mapping-file lors de l'exécution du collecteur. ## Créer un collecteur de métadonnées PowerBI {#ariaid-title10} Créez un collecteur pour importer des métadonnées à partir de PowerBI. ### Avant de commencer Avant de commencer, vérifiez les points suivants : * Un serveur MID est configuré pour les modules de collection. Pour plus d'informations, consultez [Serveur MID pour les collecteurs de métadonnées](https://servicenow-prod.fluidtopics.net/96oZaru5b4E8TR~4ba5kuQ "Configurez un serveur MID pour héberger des collecteurs de métadonnées qui collectent des métadonnées à partir de sources de données sur site et en réseau privé."). * Toutes les tâches requises sont terminées. Pour plus d'informations, consultez [Préparer l'exécution du collecteur PowerBI](https://servicenow-prod.fluidtopics.net/P9BAoPF9hF6tAfW68j8qZA#prepare-to-run-powerbi-collector "Configurez l’inscription, l’authentification et les autorisations de l’application Azure avant d’exécuter le module de collection."). * Rôle requis : connection-admin {#create-powerbi-metadata-collector__ul_pvj_mz5_bjc} ### Procédure 1. Accédez à la TousStructure de données de workflowAccueil Workflow Data Fabric. 2. Sélectionnez l'icône du ![concentrateur Connect Hub]() dans la barre latérale gauche. 3. Sélectionner CréerCollecteur de métadonnées. 4. Dans la liste Système, sélectionnez PowerBI. 5. Complétez le formulaire. {#create-powerbi-metadata-collector__table_axw_2j2_h3c__entry__2} | Champ | Description | |-|-| | Nom de la connexion | Identificateur unique pour la connexion. Ce champ n'est pas modifiable une fois la connexion établie. | | Description brève | Objet et détails de la connexion. | [Tableau 11. Nouveau formulaire de collecteur de métadonnées PowerBI Gov] {#create-powerbi-metadata-collector__table_axw_2j2_h3c} 6. Configurez les options d'authentification. {#create-powerbi-metadata-collector__table_h4k_3g2_h3c__entry__2} | Champ | Description | |-|-| | Authentifier à l'aide du nom d'utilisateur et du mot de passe Azure | Nom d'utilisateur et mot de passe Azure Active Directory. Définissez l'ID de locataire Azure si vous souhaitez spécifier l'ID de locataire Azure tout en utilisant le nom d'utilisateur et l'authentification par mot de passe. | | Authentifier à l'aide du principal du service Azure | ID de locataire de l'application Azure Active Directory pour l'application Power BI. Pour trouver l'ID de locataire, sélectionnez le point d'interrogation dans l'application Power BI, puis choisissez À propos de Power BI. L'ID de locataire se trouve à la fin de l'URL de locataire. | [Tableau 12. Options d'authentification] {#create-powerbi-metadata-collector__table_h4k_3g2_h3c} 7. Configurez les détails de l'ID client et du secret client. {#create-powerbi-metadata-collector__table_sdh_552_m3c__entry__2} | Champ | Description | |-|-| | Microsoft Entra client ID | ID du client d'application pour l'application PowerBI. | | Secret client Microsoft Entra | Secret client de l'application pour l'application PowerBI. | [Tableau 13. Détails de la configuration] {#create-powerbi-metadata-collector__table_sdh_552_m3c} 8. Configurez le champ d'application et les options de filtres de l'espace de travail. {#create-powerbi-metadata-collector__table_qpw_5xc_j3c__entry__2} | Champ | Description | |-|-| | Désactiver la collecte de traçabilité | Option permettant d'ignorer la collecte des métadonnées de traçabilité à partir des expressions sources Power BI. | | Contenu du catalogue Mon espace de travail de l'utilisateur | Option permettant de cataloguer le contenu de Mon espace de travail d'un utilisateur dans Power BI. Par défaut : ignorez l'espace de travail de l'utilisateur. | | Cataloguer tous les espaces de travail et applications du locataire | Option permettant de cataloguer tous les espaces de travail et toutes les applications d'un locataire, plutôt que seulement les espaces de travail et les applications auxquels les informations d'identification ont un accès explicite. Les privilèges d'administrateur sont requis pour les informations d'identification utilisées. | | Inclure les espaces de travail Power BI | Espaces de travail à collecter. Entrez le nom exact de l'espace de travail ou une expression régulière pour le match. Remarque : Si un nom d'espace de travail comprend des caractères spéciaux \[. , + , \* , ? , \^ , $ , ( , ) , \[ , \] , { , } , \| , \\\], échappez chaque caractère spécial avec une barre oblique inverse (\\). Par exemple, saisissez Espace de travail \\(Dev\\) pour l'espace de travail (Dev). | | Exclure les espaces de travail Power BI | Espaces de travail Power BI et leur contenu à exclure du catalogage. Entrez le nom exact de l'espace de travail ou une expression régulière pour le match. Si les deux options Inclure les espaces de travail et Exclure les espaces de travail sont configurées, l'option Inclure les espaces de travail a priorité. Remarque : Si un nom d'espace de travail comprend des caractères spéciaux \[. , + , \* , ? , \^ , $ , ( , ) , \[ , \] , { , } , \| , \\\], échappez chaque caractère spécial avec une barre oblique inverse (\\). Par exemple, saisissez Espace de travail \\(Dev\\) pour l'espace de travail (Dev). | [Tableau 14. Options de périmètre et de filtres de l'espace de travail] {#create-powerbi-metadata-collector__table_qpw_5xc_j3c} 9. Configurez les options de connexion et de fiabilité. {#create-powerbi-metadata-collector__table_yhb_plp_33c__entry__2} | Champ | Description | |-|-| | Longueur maximale de l'expression Power BI | Nombre maximal de caractères dans une expression Power BI analysée pour les métadonnées de traçabilité. Les expressions plus longues que cette valeur sont ignorées. Par défaut : 32000 | | Fichier de mappage de nom de source de données | Fichier qui mappe les détails de la source ODBC configurés dans le fichier [datasources.yml](https://servicenow-prod.fluidtopics.net/P9BAoPF9hF6tAfW68j8qZA#prep-to-run-powerbi-collector-lineage-mapping "Créez un fichier YAML pour mapper des sources de données pour la collecte de lignées."). Chargez le fichier si vous avez configuré les détails de la source ODBC. | | Images d'aperçu du rapport de catalogue | Option permettant d'afficher un aperçu des images dans le catalogue. Valeur par défaut : false | | Désactiver l'attente maximale des demandes | Option pour désactiver l'attente de réinitialisation des limites de limitation par l'API Power BI (code d'erreur 429). Lorsqu'il n'est pas sélectionné, le module de collection effectue de nouvelles tentatives toutes les 5 minutes, jusqu'à une heure. Lorsque cette option est sélectionnée, les paramètres Max retries (Nombre maximal de nouvelles tentatives) et Délai de nouvelle tentative sont utilisés à la place. | | Nombre max. d'essais | Nombre de fois que le système retente un appel d'API ayant échoué. Par défaut : 5 | | Délai de nouvelle tentative | Nombre de secondes à attendre entre les tentatives pour un appel d'API ayant échoué. Par défaut : 2 secondes | [Tableau 15. Options de connexion et de fiabilité] {#create-powerbi-metadata-collector__table_yhb_plp_33c} 10. Sélectionnez Enregistrer. ### Résultats Le collecteur de métadonnées est créé et apparaît sur la page Connecteurs avec un état Configuré. Il est maintenant prêt à se connecter au système source et à récolter des métadonnées. ### Que faire ensuite Après avoir créé le collecteur, vous pouvez effectuer l'une des tâches suivantes : * Exécutez le collecteur manuellement pour collecter immédiatement les métadonnées. Consultez [Exécuter manuellement les collecteurs de métadonnées](https://servicenow-prod.fluidtopics.net/PjH3Yx9SBUdPPmT_v8n~gQ "Exécutez un collecteur de métadonnées sur demande pour importer immédiatement les métadonnées."). * Automatisez la collecte de métadonnées en planifiant des exécutions régulières du collecteur. Consultez [Planifier les exécutions du collecteur de métadonnées](https://servicenow-prod.fluidtopics.net/RCa0EIjtP0~RtqGLtHIfbg "Planifiez un collecteur de métadonnées pour qu’il s’exécute automatiquement à une fréquence spécifiée."). * Surveillez l'état d'exécution et résolvez les problèmes en consultant les journaux d'exécution. Consultez [Afficher les journaux d'exécution pour les exécutions des collecteurs](https://servicenow-prod.fluidtopics.net/5SQQlRRrff9sVJ9IAc4zsQ "Accédez aux journaux d’exécution et téléchargez des fichiers journaux détaillés pour les exécutions du collecteur de métadonnées."). * Découvrez et évaluez les ressources de données collectées dans le catalogue de données. Consultez [Régir le Catalogue de données](https://servicenow-prod.fluidtopics.net/cmXX7g9XTst4qitIVoLx2w "Les administrateurs des données ajoutent un contexte professionnel aux actifs de catalogue, ce qui les rend plus détectables par les consommateurs de catalogue. Les outils de gouvernance comprennent des termes de glossaire, des balises, des domaines et des mises à jour directes des actifs.").