Collecteur de métadonnées PowerBI

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 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 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

    Le module de collection prend en charge Power BI Cloud API v 1.0.

    Authentification prise en charge

    Power BI prend en charge deux méthodes d’authentification :
    • Principal du service
    • Utilisateur et mot de passe
    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

    Le collecteur Power BI répertorie les informations suivantes :

    Tableau 1. Métadonnées collectées
    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

    Relations entre les objets

    Les pages de catalogue affichent les relations entre les types de ressources de données suivants :

    Tableau 2. Relations entre les objets catalogués
    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

    Traçabilité pour PowerBI

    Les informations de traçabilité suivantes sont collectées par le collecteur Power BI. Le collecteur utilise les API de l’analyseur Power BI pour établir la traçabilité avec les tables et colonnes sources. Assurez-vous de vous familiariser avec les limites des API de scanner

    Tableau 3. Disponibilité de traçabilité par objet
    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

    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.

    Tableau 4. Transformations et expressions prises en charge pour la collecte des métadonnées de traçabilité
    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 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 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 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

    Préparer l’exécution du collecteur PowerBI

    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.
    2. Configurez l’authentification en fonction de votre méthode préférée.
    3. Activez l’analyse des métadonnées pour accéder à des informations détaillées sur les sources de données.
    4. Obtenez l’ID de locataire Power BI.
    5. Facultatif : Configurez 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.

    Inscrire l’application Power BI

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

    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.

    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ètres > Portail 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

    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.

    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

    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 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 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 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.
      • 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

    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

    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ètres > Portail d’administration.
      3. Localisez et activez le paramètre Exporter les rapports sous forme de fichiers image dans les paramètres Admin.
    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.

    Configurer le mappage de traçabilité Power BI

    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 :

    Tableau 5. Scénarios de mappage de traçabilité
    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
    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 or data source key in Power BI source>"
          host: <my-datasource-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: "<host or data source key in Power BI source>"
          OR
         - name: <data source name>
         host: <my-datasource-host>
         databaseUsername: <username> # recommend setting up env variable
         databasePassword: <password> # 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:
          - <database_name>

        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: <my-datasource-host>
        databaseType: <type-of-database>
        databaseUsername: <username> # optional
        databasePassword: <password> # optional
        defaultDatabaseName: <database name> # 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 :

      Tableau 6. Propriétés JDBC
      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

      Options d’informations d’identification de la base de données Snowflake :

      Tableau 7. Options de flocon de neige
      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

      Options d’informations d’identification de la base de données Databricks :

      Tableau 8. Options de Databricks
      Option Description
      databricksHttpPath Requis si la base de données source est Databricks

      Options de base de données autonome Oracle :

      Tableau 9. Options de base de données autonome Oracle
      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:<host>:<port>/<service_name>, 
      jdbc:oracle:thin:@(address=(protocol=tcps)(port=<port>)(host:<host>))
      (connect_data=(service_name=<service_name>))
      (security=(ssl_server_dn_match=yes)), 
      or jdbc:oracle:thin:@alias_name?TNS_ADMIN=/path/to/wallet
      

      Options BigQuery :

      Tableau 10. Options BigQuery
      Option Description
      projet Requis si la source est une table BigQuery
      bigQueryCredentialJsonString Requis pour fournir des informations d’identification 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

    Créez un collecteur pour importer des métadonnées à partir de PowerBI.

    Avant de commencer

    Avant de commencer, vérifiez les points suivants :

    Procédure

    1. Accédez à la Tous > Structure de données de workflow > Accueil Workflow Data Fabric.
    2. Sélectionnez l’icône du concentrateur Connect Hub dans la barre latérale gauche.
    3. Sélectionner Créer > Collecteur de métadonnées.
    4. Dans la liste Système, sélectionnez PowerBI.
    5. Complétez le formulaire.
      Tableau 11. Nouveau formulaire de collecteur de métadonnées PowerBI Gov
      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.
    6. Configurez les options d’authentification.
      Tableau 12. Options d'authentification
      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.
    7. Configurez les détails de l’ID client et du secret client.
      Tableau 13. Détails de la configuration
      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.
    8. Configurez le champ d’application et les options de filtres de l’espace de travail.
      Tableau 14. Options de périmètre et de filtres de l’espace de travail
      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).
    9. Configurez les options de connexion et de fiabilité.
      Tableau 15. Options de connexion et de fiabilité
      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 . 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

    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 :