Connecteur Power BI Services (Cloud)

Cet article explique comment utiliser le connecteur Power BI Services (Cloud) pour DataGalaxy.

Ce connecteur est disponible dans les modes suivants :

Ce connecteur supporte les modes d'import suivants :

Technologie

Power BI est un ensemble de services logiciels, d’applications et de connecteurs qui œuvrent ensemble pour transformer des sources de données disparates en insights cohérents, visuellement immersifs et interactifs.

Périmètre

Il existe deux manières de récupérer les métadonnées de Power BI : en utilisant l'API Admin ou l'API Non-admin. Pratiquement tout le périmètre peut être récupéré en utilisant l'API Admin (à l'exception des pages des Rapports) mais cela nécessite un niveau de permissions plus élevé. A l'inverse, l'API Non-admin est moins intrusive en termes de permissions mais permet de récupérer moins de métadonnées. 

Vous pouvez configurer l'un ou l'autre ou les deux types de permissions au Service Principal utilisé par le connecteur. Le connecteur essaiera de récupérer le maximum de métadonnées en fonction des permissions qui ont été données. Voir plus loin dans cette page pour le paramétrage des permissions.

Voici un récapitulatif des métadonnées qui peuvent être récupérées avec l'un ou l'autre des modes :

Certains de ces attributs sont complémentaires et spécifiques à la technologie ainsi qu'au type d'objet. Pour les faire apparaître dans les écrans DataGalaxy, il peut être nécessaire d'adapter les écrans des objets concernés. Consultez cet article pour en savoir plus sur la personnalisation des écrans. 

Lineage

Le lineage interne à Power BI est extrait entre les objets suivants :

• Datasets et Reports
• Reports et Dashboards
• Reports/Dashboards et Apps
• Datasets et Datasets
• Dataflows et Datasets

Le lineage ascendant avec les plateformes data sources peut être extrait par le connecteur (seulement en mode URN). Les technologies suivantes sont supportées :

• Snowflake
• Google BigQuery
• Databricks
• MS SQL Server

Le lineage avec les sources est extrait au niveau table. Les NativeQueries dans les définitions des datasets ne sont pas supportées donc aucun lineage ne sera extait de ces datasets. Les variables sont interprétées si leur valeur est disponible. Les valeurs dynamiques qui ne sont définies qu'à l'exécution, comme les concaténations, ne peuvent pas être évaluées.

Périmètre détaillé

Entrée

• Depuis votre page d’accueil PowerBI, les espaces de travail sont accessibles en cliquant sur l’onglet du même nom 

• Toujours depuis votre page d’accueil PowerBI, les Applications ont également leur onglet dédié

• En ciblant un espace de travail donné vous aurez accès à la liste des rapports, modèles sémantiques, flux de données et tableaux de bord qu’il contient (exemple avec l’espace de travail “[Dev] Observabilité” ici)

• Depuis l’écran précédent, en cliquant sur un modèle sémantique donné vous serez amené vers une nouvelle page dédiée sur laquelle se trouve le bouton “Explorer ces données” (capture 1). Celui-ci une fenêtre s’ouvre qui donne le détail des tables et colonnes dudit modèle (capture 2, exemple avec “[AWS] Activity” ici)

• Toujours depuis l’écran qui résume les objets d’un workspace donné, en cliquant sur un flux de données vous arriverez directement sur un écran vous permettant de consulter les entités (tables) et attributs des entités (colonnes) (exemple avec “Demo_flux”)

• Enfin, en cliquant sur un rapport donné depuis l’écran qui résume les objets d’un workspace, il s’affichera avec à gauche la liste des pages

Sortie

• Application, Rapport et Composant Usage (exemple d’import via l’API Non-admin)

• DataSet et Champ Usage (exemple d’import via l’API admin) 

• Lien entre DataSet et Rapport (exemple d’import via l’API admin)

Configuration de la connexion

Côté PowerBI

Le connecteur a besoin d'un Service Principal pour discuter avec l'API Power BI. Cette section décrit comment en créer un dans Entra ID puis comment allouer les permissions, pour les API Non-admin et/ou Admin. Pour rappel, vous pouvez autoriser l'un ou l'autre ou les deux types de permissions au Service Principal, selon le périmètre que vous souhaitez remonter avec le connecteur.

Créer un Service Principal

Que l’on cherche à faire un import via l’API admin ou Non-admin il va être nécessaire de réaliser 3 étapes dans Azure:

• Enregistrer une application (c’est via celle-ci que l’on va pouvoir récupérer les informations de connexion nécessaires)
• Créer un groupe
• Ajouter notre application à ce groupe

        Enregistrer une application

• Depuis votre écran d’accueil Azure commencez par sélectionner le service “Microsoft EntraID”

• Sur le menu de gauche vous aurez accès à “App registrations”. De là vous pourrez choisir “+ New registration” (capture 1) et suivre les étapes de création (capture 2). Renseignez simplement le nom et nous conseillons de rester sur la première option dans “Supported account types” avant de cliquer sur “Register” pour finaliser l’opération

Depuis la page d’accueil Microsoft Entra ID vous pourrez retrouver l’application créée dans “App registrations”, en allant ensuite dans l’onglet “Owned applications” ou en utilisant la
barre de recherche de l’onglet “All applications” (capture 1). C’est en cliquant sur votre application que vous atterrirez sur sa page “Overview” qui résume notamment l’ensemble des informations de connexion nécessaires plus tard (capture 2).

Sachez qu’en parallèle de l’application créée dans “App registrations”, 

Azure va automatiquement créer une application d’entreprise que vous retrouverez en allant dans l’onglet “Enterprise applications” de la page d’accueil Microsoft Entra ID, puis en tapant le nom de votre application dans la barre de recherche. 

C’est cette application d’entreprise qui sera ajoutée au groupe que nous allons créer plus loin dans le tutoriel.

• Une fois l’application créée, depuis sa page dédiée vous aurez à gauche accès à “Certificates and secrets”. Depuis la page vous pourrez créer un nouveau secret via le bouton “+ New client secret” (capture 1). Une fois les étapes suivies le secret sera créé (capture 2) 

Une fois le secret créé notez bien sa valeur et ne la perdez pas, elle ne vous est donnée qu'une fois.

        Créer un groupe

• Depuis la page d’accueil Microsoft Entra ID vous avez à gauche accès à “Groups” (capture 1). En cliquant dessus vous aurez accès au bouton vous permettant d’ajouter un nouveau groupe, “New group” (capture 2) 

• En cliquant sur “New group” vous ouvrirez une nouvelle page. Vous aurez notamment le choix du type (choisissez “Sécurité”) et du nom du groupe avant de valider en cliquant sur “Create” (capture 1). Une fois la création validée le groupe sera visible (filtrez en utilisant la barre de recherche si nécessaire) (capture 2) 

Si vous ne créez pas un groupe de type "Sécurité", vous ne serez pas en mesure d'ajouter plus tard votre application d'entreprise à celui-ci.

        Ajouter notre application à ce groupe

• Pour ce faire, depuis la fenêtre précédente cliquez sur le groupe nouvellement créé (”Doc_freshdesk” ici). Vous arriverez sur la page qui résume les caractéristiques du groupe. De là sélectionnez à gauche l’option “Members”, qui vous ouvrira la page dédiée à la gestion des membres 

• Depuis cette page de gestion des membres il vous faudra successivement:
  •  cliquer sur le bouton “+ Add members” pour ajouter un membre
  • taper dans la barre de recherche apparue à droite le nom de l’application d’entreprise créée un peu plus tôt (”PowerBI_New” ici)
  • l’ajouter en cochant la case à gauche du nom puis en cliquant sur le bouton “Select” au bas de la page

Comme précisé plus tôt, si le groupe ("Doc_freshdesk" ici) n'est pas de type "Sécurity", vous ne serez pas en mesure de trouver votre application d'entreprise, même en tapant son nom dans la barre de recherche ("PowerBI_New" ici).

Une fois ces étapes effectuées, en fonction du type d’import que vous souhaitez réaliser la procédure à suivre sera différente.

Autoriser l'API Non-admin 

Afin de réaliser un import via l’API Non-admin 2 étapes de configuration supplémentaires sont nécessaires:

• autoriser votre groupe à accéder à l’API Non-admin (PowerBI)
• autoriser votre groupe à accéder à un workspace donné (PowerBI)

        Autoriser votre groupe à accéder à l'API Non-admin (PowerBI)

Cette étape doit être réalisée par un Administrateur Power BI.

• pour commencer accédez au portail d’administration en sélectionnant dans PowerBI “paramètres” puis “portail d’administration”

Si "Portail d'Administration" n'apparait pas, c'est que vous ne disposez pas des autorisations suffisantes sur votre compte PowerBI.

• depuis la fenêtre nouvellement ouverte effectuez ces 3 opérations:
  • sélectionnez “Paramètres du client”
  • descendez jusqu’à trouver “Paramètres du développeur”
  • déployez “Autoriser les principaux de service à utiliser les API Power BI”
  • activez l’option si nécessaire
  • appliquez cela à des groupes de sécurité spécifique
  • ajoutez le groupe que vous avez créé pour l’occasion (”Doc_freshdesk” ici)
  • finalisez l’opération en cliquant sur “Appliquer”

        Autoriser votre groupe à accéder à un workspace donné (PowerBI)

La suite des opérations se déroulera directement dans votre espace PowerBI. Pour chacun des workspaces dont vous voulez remonter les informations dans DataGalaxy il faudra effectuer les actions suivantes:

• depuis l’écran d’accueil cliquez sur “Espace de travail” puis choisissez celui dont vous voulez remonter les informations (”[Dev] Observabilité” ici)

• une fois sur l’écran du workspace cliquez sur “Gérer l’accès”. Cela déploiera une fenêtre à droite d’où vous pourrez sélectionner “+ Ajouter des personnes ou des groupes”

• de là vous pourrez taper dans la barre de recherche le nom du groupe créé précédemment dans Microsoft Entra ID (”Doc_fresdesk” ici) puis l’ajouter

• le groupe est désormais membre du workspace et y aura accès via l’API Non-admin  

Voilà, en utilisant le connecteur DataGalaxy vous couvrirez désormais le périmètre “API Non-admin” du connecteur 

Autoriser l'API Admin

Cette étape doit être réalisée par un Administrateur Power BI.

Afin de réaliser un import via l’API admin les étapes de configuration sont plus simples. Il suffit d’autoriser votre groupe à accéder à l’API admin via PowerBI.

Pour ce faire:

• accédez au portail d’administration en sélectionnant dans PowerBI “paramètres” puis “portail d’administration”

Si "Portail d'Administration" n'apparaît pas, c'est que vous ne disposez pas des autorisation suffisantes sur votre compte PowerBI.

• depuis la fenêtre nouvellement ouverte effectuez ces 3 opérations:
  • sélectionnez “Paramètres du client”
  • descendez jusqu’à trouver “Paramètres de l’API d’administration”
  • pour chacun des 3 paramètres présents (”Autoriser les principaux de service à utiliser les API d’administration en lecture seule”, “Améliorer les réponses des API d’administration avec des métadonnées détaillées” et “Améliorer les réponses des API d’administration avec des expressions DAX et mashup”) effectuez les actions suivantes:
    • déployez l’onglet
    • activez l’option si nécessaire
    • appliquez cela à des groupes de sécurité spécifique
    • ajoutez le groupe que vous avez créé pour l’occasion (”Doc_freshdesk” ici)
    • finalisez l’opération en cliquant sur “Appliquer”

Détails pour ”Les principaux de service peuvent accéder aux API d’administration en lecture seule”:

Détails pour ”Améliorer les réponses des API d’administration avec des métadonnées détaillées”:

Détails pour ”Améliorer les réponses des API d’administration avec des expressions DAX et mashup”:

Voilà, en utilisant le connecteur DataGalaxy vous couvrirez désormais le périmètre “API admin” du connecteur

Côté DataGalaxy

Les informations suivantes sont demandées pour configurer une connexion :

Du mode Standard au mode URN

Différences

1. En mode Standard le nom de votre objet racine sera celui que vous lui donnerez lorsque vous créez la connexion (ou de l'objet racine du module Usages que vous ciblerez). En mode URN le nom de l'objet racine sera le tenant id utilisé lors du paramétrage de la connexion (note : vous pouvez changer le nom fonctionnel de cet objet pour un nom plus parlant, sans risque qu'il soit écraser par la suite par le connecteur).
   1. Mode Standard
   2. Mode URN

Guide de migration

Ce guide a pour but de vous indiquer les étapes à suivre pour passer votre objet racine et tous les objets PowerBI qu'il contient du mode Standard au mode URN. Une fois ces étapes effectuées, vous serez en mesure de réaliser tous vos futurs imports en mode URN et de profiter des nouvelles fonctionnalités associées à ce mode.

1. Si ce n'est pas encore le cas, associer aux objets du module "Usages" l'attribut "URN"
2. Associer à votre objet racine l'URN correspondant
   • A ce propos nous conseillons de suivre les étapes suivantes pour éviter toute erreur:
     • Réaliser un import en mode URN, lequel va créer un nouvel objet racine pour lequel l'attribut URN sera renseigné
     • Copier ledit attribut URN
     • Supprimer l'objet racine que vous venez d'importer en mode URN ainsi que tous ses enfants (vu qu'un URN doit être unique, si vous ne supprimez pas cet objet racine avant d'assigner son URN à un autre objet la plateforme retournera une erreur)
     • Coller l'URN pour renseigner l'attribut URN de votre objet racine qui est encore en mode Standard
3. Réaliser un nouvel import en mode URN
   • Cette fois-ci tous les attributs URN des enfants sous votre objet racine devraient être renseignés

Félicitations, vous avez migré du mode Standard au mode URN et êtes en mesure de profiter de toutes les nouvelles fonctionnalités offertes par celui-ci !

Exécution du connecteur

Pour créer une connexion à Power BI via le connecteur Online, les points d'entrées sont les suivants : 

• Depuis le bouton Importer du widget "Raccourcis" présent sur l'écran d'accueil d'un espace client ou d'un espace de travail 
• Depuis le bouton Importer d'un des modules lorsque celui-ci est vide
• Depuis le bouton Importer du menu contextuel d'un des modules, à droite des vues filtrées
• Depuis le bouton Ajouter une connexion dans l'onglet Connecteur disponible dans l'écran de réglage d'un espace de travail

Vous pouvez éventuellement filtrer (par module, type de connecteur ou en utilisant la barre de recherche), puis cliquer sur la technologie souhaitée :

Il faut ensuite compléter le formulaire de connexion à l'aide des informations de connexion décrites précédemment pour réaliser un import. Pour plus de détails sur les étapes d'exécution du connecteur Online, vous pouvez consultez l'article suivant : [HowTo] Exécution du Connecteur Online. 

Cette technologie est également disponible via le connecteur Desktop, vous trouverez plus d'informations sur ce mode opératoire ici : [How to] Mode opératoire du connecteur.

Questions Fréquentes

Pourquoi la structure (tables et champs) de certains data sets Power BI (semantic models) n'est pas renseignée dans DataGalaxy ?

Tous les data sets ne supportent pas la récupération de leur structure via l'API Power BI. Dans certains cas, par exemple pour des data sets utilisant des connexions live, la structure ne peut être récupérée. Dans ce cas, l'API retourne un code erreur explicite schemaRetrievalError pour ce data set, avec un message informant de la raison, par exemple "Unsupported request. On-premise or ASAzure dataset are not supported.". Pour vérifier si cela pourrait être votre problème, vous pouvez exécuter le connecteur avec les logs verbeux puis chercher ce code erreur schemaRetrievalError dans le fichier de logs.

Pourquoi le lineage lié à mes rapports ne remonte pas ?

Le lineage automatique existe entre Power BI et les sources lorsque :

• Le mode URN du connecteur Power BI et des différentes sources est activé.
• Le dataset Power BI utilise une connexion classique. Les cas "non classiques" sont les suivants :
  • Utilisation de NativeQuery avec du SQL personnalisé (ou plus généralement toute méthode s'appuyant sur une requête SQL personnalisée)
  • Utilisation de paramètres dans les requêtes

Releases