Service Microsoft Azure Power BI (Repository) - Import

Spécifications du pont

Fournisseur	Microsoft
Nom de l'outil	Azure Power BI
Version de l'outil	2.x
Site Web de l'outil	https://powerbi.microsoft.com/
Méthodologie supportée	[Business Intelligence] Multimodèle, Référentiel de métadonnées, Data Store (Modèle de données physique, Modèle dimensionnel OLAP, Parsage d'expressions de procédures stockées), Rapport BI (Source relationnelle, Source dimensionnelle, Parsage d'expressions, Structure de rapports) via une API REST Java
Profiling de données
Collecte incrémentale
Collecte multi-modèle
Navigation dans le référentiel distant pour sélectionner un modèle

SPÉCIFICATIONS
Outil : Microsoft/Base de données Azure SQL version 12.x ou supérieure via l'API JDBC
Consultez http://azure.microsoft.com/fr-fr/services/sql-database/
Métadonnées : [Base de données relationnelle] Multimodèle, Data Store (Modèle de données physique, Parsage d'expressions de procédures stockées)
Composant : JdbcMicrosoftAzureSqlDatabase version 11.2.0

AVERTISSEMENT
Ce pont d'import requiert un accès à Internet pour télécharger les bibliothèques tierces :
- par exemple https://repo.maven.apache.org/maven2/ pour télécharger les bibliothèques tierces open source,
- et plus de sites pour d'autres logiciels tiers, comme les pilotes JDBC spécifiques pour les bases de données.

Les bibliothèques tierces téléchargées sont stockées dans $HOME/data/download/MIMB/
- Si le protocole HTTPS échoue, le pont d'import essaye ensuite avec HTTP.
- Si un proxy est utilisé pour accéder à Internet, vous devez configurer ce proxy dans l'environnement JRE (voir l'option -j dans le paramètre Divers).
- Si le pont d'import n'a pas d'accès à Internet, le répertoire $HOME/data/download/MIMB/ peut être copié depuis un autre serveur qui a accès à Internet, où la commande $HOME/bin/MIMB.sh (ou .bat) -d peut être utilisée pour télécharger en une fois toutes les bibliothèques tierces utilisées par tous les ponts.

En exécutant ce pont d'import, vous reconnaissez être responsable des conditions d'utilisation et de toute autre faille de sécurité potentielle liées au téléchargement de ces bibliothèques logicielles tierces.

VUE D'ENSEMBLE
Ce pont d'import importe des métadonnées de rapports Business Intelligence (BI) depuis le service Microsoft Power BI hébergé sur le Cloud Microsoft Azure, à l'aide des API REST Power BI (les API Admin par défaut).

Ce pont d'import permet de cataloguer les types d'objets :
- Espaces de travail (Groupes)
- Dashboards
- Rapports Power BI
- Rapports paginés
- Jeux de données (Modèles sémantiques)
- Flux de données
- Sources de données

PRÉREQUIS

- Prérequis à l'authentification :
Lorsque vous vous connectez au service Power BI hébergé dans le Cloud Microsoft Azure, le pont d'import utilise l'authentification Azure Active Directory.
Ce pont s'appuie sur le Microsoft Authentication Library (MSAL) afin d'authentifier auprès d'Azure Active Directory.

Les étapes de configuration suivantes sont requises pour inscrire une application dans le Cloud global Azure.
- Connectez-vous à la console de gestion d'Azure : https://portal.azure.com/
- Créez ou ouvrez le service Azure Active Directory qui correspond à votre entreprise.
- Sur la page Inscription d'applications, créez une inscription d'application nommée "MIMB" de type "Client natif" et saisissez son identifiant client (identifiant d'application).
- Veillez à ajouter une autorisation pour l'application Power BI Service et octroyez les autorisations nécessaires.
Par exemple, vous pouvez attribuer les autorisations "Power BI Service" :
Dashboard.Read.All, Dataflow.Read.All, Dataset.Read.All, Gateway.Read.All, Report.Read.All, Tenant.Read.All, Workspace.Read.All

Si vous souhaitez inscrire l'application dans un cloud Azure national, suivez des étapes similaires en utilisant une URL différente pour la console de gestion Azure, correspondant à votre environnement Cloud national.
Pour plus d'informations, veuillez consulter : https://learn.microsoft.com/fr-fr/azure/active-directory/develop/authentication-national-cloud
Veuillez utiliser le paramètre "Azure environment" pour spécifier votre environnement Cloud national.

Le pont d'import utilise les informations d'identifiant client (identifiant d'application) pour se connecter à Azure et obtenir le jeton d'authentification.
Pour plus d'informations :
https://docs.microsoft.com/fr-fr/azure/active-directory/develop/active-directory-integrating-applications

Il est également possible d'inscrire l'application dans Azure Active Directory en utilisant cette page :
https://dev.powerbi.com/apps
Notez que l'octroi d'autorisations spécifiques peut être nécessaire pour utiliser la console de gestion Azure.

Vous pouvez également utiliser Office 365 Admin Center pour configurer les utilisateurs - via la console de gestion Azure Active Directory (en bas à gauche de l'écran) et la souscription à Power BI (licence) :
https://admin.microsoft.com/
Cela fournit une configuration des utilisateurs, groupes et de l'enregistrement de l'application avec granularité fine.

Il existe deux façons de s'authentifier à Azure Active Directory :
- En tant qu'utilisateur normal : l'identifiant d'utilisateur est généralement une adresse e-mail. Par exemple :
UserName@DirectoryName.onmicrosoft.com
- En tant que Principal de service : le paramètre de nom d'utilisateur ne doit pas être renseigné et l'identifiant du tenant doit être fourni.

Le pont d'import requiert les API améliorées de scan des métadonnées Microsoft, pour récupérer les structures de tables du jeu de données et les expressions de mashup PowerQuery.
Elles ne sont disponibles qu'avec les API Admin et requièrent les étapes de configuration ci-dessous.

Pour une authentification en tant que Principal de service, vous pouvez configurer des droits supplémentaires sur cette page :
https://app.powerbi.com/admin-portal/tenantSettings
- - Paramètres de développeur/Autoriser les Principaux de services à utiliser les API Power BI
- Paramètres d'API Admin/Autoriser les Principaux de services à utiliser les API Admin Power BI en lecture seule
- Paramètres d'API Admin/Améliorer les réponses des API Admin grâce à des métadonnées détaillées (pour les tables et les colonnes Dataset)
- Paramètres d'API Admin/Améliorer les réponses des API Admin grâce à des métadonnées détaillées (pour les tables et les colonnes Dataset)
De plus, pour activer le téléchargement des rapports, vous pouvez configurer :
- Paramètres d'export et de partage/Télécharger les rapports

- Prérequis à l'API :
Ce pont d'import utilise les API Admin Power BI par défaut.

Pour pouvoir utiliser les API Admin, veuillez :
- attribuer le rôle Admin Power BI à l'utilisateur lorsqu'il utilise les permissions déléguées (Connexion en tant qu'utilisateur connecté).
- retirer les rôles Power BI donnés à l'application (Tenant.ReadWrite.All, Tenant.Read.All), grâce à la console Azure Active Directory, lorsqu'il utilise l'authentification du principal de service.
- Dans Azure Active Directory, créez un groupe de sécurité et ajoutez-y le compte Principal de Service.
- Activez l'accès à vos espaces de travail au Principal de Service et/ou au groupe de sécurité :
utilisez le service Powerbi.com en étant connecté à votre compte et en sélectionnant le Workspace (Espace de travail)
en navigant vers Manage Access (Gérer l'accès)/Add people or groups (Ajouter des personnes ou des groupes)
sélectionnez l'utilisateur ou le groupe (ou le compte du Principal de Service)
configurez-le comme Admin
- Pour télécharger des rapports, l'utilisateur ou le groupe doit être attribué à l'espace de travail ou aux espaces de travail en tant que Contributor (Contribueur) ou Admin
Pour plus d'informations, veuillez consulter :
https://docs.microsoft.com/fr-fr/power-bi/admin/service-admin-metadata-scanning
https://docs.microsoft.com/fr-fr/power-bi/admin/service-admin-metadata-scanning-setup
https://docs.microsoft.com/fr-fr/power-bi/admin/read-only-apis-service-principal-authentication
https://docs.microsoft.com/fr-fr/power-bi/developer/embedded/embed-service-principal#service-principal-vs-master-account

Ce pont d'import peut utiliser, de manière alternative, les API habituelles (au lieu de API Admin), vous devez :
- configurer le paramètre Divers : -api.user
Notez que dans ces cas, les métadonnées de lignage détaillé ne sont pas extraites.

FOIRE AUX QUESTIONS
- Si le message d'erreur ci-dessous s'affiche, l'administrateur devra peut-être vous accorder son consentement.
AADSTS65001 : l'utilisateur ou l'administrateur n'a pas accordé son consentement pour utiliser l'application avec l'identifiant "{client-id}" nommé "MIMB". Envoyez une demande d'autorisation interactive pour cet utilisateur et cette ressource.
Demandez à l'administrateur d'accorder son consentement en utilisant une URL telle que : https://login.microsoftonline.com/{tenant-id}/adminconsent?client_id={client-id}
Pour plus d'informations : https://docs.microsoft.com/fr-fr/azure/active-directory/manage-apps/grant-admin-consent

LIMITATIONS
Consultez les limitations générales connues à l'adresse https://metaintegration.com/Products/MIMB/Help/#!Documents/mimbknownlimitations.html

- Limitations des API Admin :
- Les métadonnées extraites du jeu de données via les API Admin sont importantes (par ex. la structure des tables du jeu de données et les expressions de mashup PowerQuery sont extraites) mais pas aussi complètes que les données des Modèles Objets Tabulaires (Tabular Object Model, TOM) complètement extraites du pont d'import PBIT.
- Les métadonnées de rapport extraites via les API Admin sont très limitées par rapport à ce qu'il est possible d'extraire depuis le pont d'import PBIT.
- Les autres limitations des API Admin sont documentées ici : https://docs.microsoft.com/fr-fr/power-bi/admin/service-admin-metadata-scanning
- Pour des métadonnées détaillées des rapports, le pont s'appuie sur la capacité à télécharger des rapports.
Les limitations du téléchargement de rapports sont documentées ici : https://learn.microsoft.com/fr-fr/power-bi/create-reports/service-export-to-pbix#limitations

- Limitations des API standards :
- les métadonnées de lignage ne sont disponibles qu'au niveau du modèle ou de la connexion, pas à celui de la table ou de la colonne.
- Power BI supporte six types de jeux de données : 'Push', 'Streaming', 'PushStreaming', 'AzureAS', 'AsOnPrem' ainsi que les jeux de données des fichiers PBIX mis en ligne.
- la structure des jeux de données (celle des tables et des colonnes) n'est exposée que pour les types de jeux de données 'Push' et 'PushStreaming', en raison de limitations des API.

- Limitations du parsage PowerQuery M Language :
Le pont s'appuie sur le parseur de langage PowerQuery M pour comprendre le lignage de chaque requête de table.
Certains concepts en langage PowerQuery peuvent ne pas être bien supportés :
- certaines fonctions (fonctions d'accès aux données, fonctions de manipulation des données) ;
- requêtes complexes qui dépendent de sous-requêtes, paramètres ou fonctions personnalisées/lambda ;
- requêtes reposant sur d'autres langages de script (Kusto, Python, R)

SUPPORT
Fournissez un package de dépannage avec :
- le log de débogage (peut être défini dans l'UI ou dans conf/conf.properties avec MIR_LOG_LEVEL=6)
- la sauvegarde des métadonnées si disponible (peut être configurée dans le paramètre Divers avec l'option -backup, même si cette option commune n'est pas implémentée pour tous les ponts pour des raisons techniques).

Paramètres du pont

Mapping du pont

Les informations de mapping ne sont pas disponibles