Publier dans le service Power BI depuis SAP Databricks
Cette page décrit comment publier des données de SAP Databricks dans le service Microsoft Power BI. Le service Microsoft Power BI est une plateforme d'analytique d'entreprise basée sur le cloud qui permet aux utilisateurs de se connecter aux données, de les visualiser et de les analyser.
Lorsque vous intégrez SAP Databricks en tant que source de données au service Power BI, vous offrez le traitement et les performances des données évolutifs de Databricks à tous les utilisateurs.
Si vous souhaitez connecter Power BI Desktop à SAP Databricks, consultez Connecter Power BI Desktop à SAP Databricks.
Le connecteur SAP Databricks pour Power BI prend en charge le driver Arrow Database Connectivity (ADBC). En savoir plus ici.
Exigences
-
Vos données doivent se trouver dans Unity Catalog, et votre compute doit être compatible avec Unity Catalog. Le Hive metastore n'est pas pris en charge actuellement.
-
Vous devez disposer d'une licence Power BI Premium (capacité Premium, Premium par utilisateur (PPU) ou capacité Microsoft Fabric).
-
Vous devez activer Read Write pour l' Endpoint XMLA dans votre capacité Power BI. Suivez ce link pour obtenir des instructions.
-
Si vous vous authentifiez à l’aide d’OAuth machine-to-machine (M2M), assurez-vous d’avoir configuré un Service Principal SAP Databricks. Voir Configurer les Service Principal sur SAP Databricks pour Power BI.
-
Si les utilisateurs souhaitent modifier des modèles sémantiques dans le service Power BI après publication, vous devez activer **« Les utilisateurs peuvent modifier les modèles de données dans le service Power BI (préversion) »** dans les paramètres du workspace. Vous pouvez également modifier le modèle sémantique à l'aide de Tabular Editor en établissant une connexion via l'endpoint XMLA.
-
Si votre Workspace Power BI utilise un Link privé, vous devez mettre à jour manuellement les identifiants de la source de données du dataset dans Power BI.
-
Un warehouse Databricks SQL.
Se connecter manuellement à SAP Databricks en tant que source de données
Lorsque vous utilisez SAP Databricks comme source de données avec le service Power BI, vous pouvez créer des modèles sémantiques Power BI à partir de tables.
-
Depuis la barre latérale du service Power BI, cliquez sur Créer .
-
Cliquer sur Obtenir des données .
-
Recherchez et sélectionnez la vignette « Databricks ».
-
Saisissez l' Hostname de votre warehouse Databricks SQL et le chemin HTTP .
Pour obtenir le Hostname du serveur et le chemin HTTP :
- Dans la barre latérale SAP Databricks, cliquez sur SQL > SQL Warehouses
- Dans la liste des warehouses disponibles, cliquez sur le nom du warehouse cible.
- Sur le tab Détails de la connexion , copiez le Hostname du serveur et le chemin HTTP .
-
Facultativement, spécifiez les configurations des options avancées .
-
Assurez-vous de définir un Nom de connexion unique.
-
Choisissez votre type d'authentification :
- Informations d'identification client Databricks : authentification avec un Service Principal Databricks (OAuth machine-à-machine). Veuillez saisir l'ID client et le secret client du Service Principal. Veuillez consulter Configurer les Service Principal sur SAP Databricks pour Power BI.
- Jeton d'accès personnel : Saisissez votre jeton d'accès personnel Databricks.
- OAuth (OIDC) : cliquez sur Se connecter et terminez le processus d'authentification.
- Service Principal : authentifiez-vous avec un Service Principal Microsoft Entra ID. Saisissez les identifiants du Service Principal.
-
Sélectionnez un Niveau de confidentialité .
-
Choisissez si cette connexion peut être utilisée avec des passerelles de données on-premise et des passerelles de données VNet.
-
Cliquez sur Suivant pour créer votre connexion.
-
Sélectionnez les tables à importer dans vos rapports Power BI.
Fonctionnalités et notes
- Lors de la publication d'un schéma contenant plusieurs tables, toutes les tables avec des colonnes sont publiées. Les tables sans colonnes ne sont pas publiées.
- Les commentaires sur les colonnes d'une table dans SAP Databricks sont copiés dans les descriptions des colonnes correspondantes dans Power BI.
- Les relations de clé étrangère sont conservées dans le dataset publié. Cependant, Power BI ne prend en charge qu'un seul chemin de relation actif entre deux tables quelconques. Lorsque plusieurs chemins sont présents dans le schéma dans SAP Databricks, certaines des relations correspondantes dans Power BI sont définies comme inactives. Vous pourrez modifier ultérieurement les relations actives ou inactives dans la vue du modèle de données de Power BI.
- Lors de l'utilisation d'OAuth ou d'une passerelle de données on-premise, les identifiants pourraient avoir besoin d'être configurés sous « Identifiants de la source de données » sur la page des paramètres du dataset Power BI.
Configurer M2M OAuth
Après avoir publié sur le service Power BI depuis SAP Databricks, vous pouvez configurer l'OAuth M2M sur le service Power BI. Assurez-vous d'avoir un service principal configuré sur SAP Databricks. Voir Configurer les service principals sur SAP Databricks pour Power BI.
Vous pouvez configurer OAuth M2M à partir d'un modèle sémantique ou d'une passerelle de services.
Utiliser un modèle sémantique pour OAuth M2M
Configurez votre connexion SAP Databricks pour OAuth M2M sur le service Power BI à l'aide d'un modèle sémantique. Pour en savoir plus sur les modèles sémantiques, consultez Modèles sémantiques dans le service Power BI.
Configurer les identifiants :
- Dans Power BI, accédez au Workspace qui contient le modèle sémantique.
- Cliquez sur Plus d'options (menu kebab horizontal) > Paramètres .
- Accédez à **Informations d'identification de la source de données** et cliquez sur **Modifier les identifiants**.
- Dans Méthode d'authentification , choisissez De base .
- Dans Nom d'utilisateur , saisissez l'ID de l'application de votre Service Principal.
- Dans Mot de passe , entrez votre secret de Service Principal.
- Sélectionnez le paramètre de niveau de confidentialité approprié pour votre source de données.
- Si vous souhaitez activer l'authentification unique (SSO), activez la dernière option.
- Cliquez sur **Se connecter**.
Utilisez une passerelle de service pour OAuth M2M
Vous pouvez configurer votre connexion SAP Databricks pour l’OAuth M2M sur le service Power BI à partir d’un VNet Power BI ou d’une passerelle de données on-premise. Les identifiants client Databricks pour une passerelle on-premise nécessitent Power BI gateway v3000.270.10 ou une version supérieure. Pour en savoir plus sur les passerelles Power BI, consultez le site officiel de Microsoft.
Power BI ne prend pas entièrement en charge les passerelles de données VNet dans ses API REST. Par conséquent, vous devez mettre à jour manuellement les connexions de source de données pour utiliser les **informations d’identification du client Databricks** dans l’interface utilisateur.
Configurer les identifiants :
-
Dans Power BI, cliquez sur l'icône d'engrenage en haut à droite pour accéder aux paramètres.
-
Cliquez sur Gérer les connexions et passerelles .
-
Cliquez sur **+ Nouveau** pour créer une nouvelle connexion.
-
Sélectionnez on-premise ou réseau virtuel . Les identifiants requis sont les mêmes pour les deux passerelles.
-
Sous **Nom du cluster de passerelle**, sélectionnez la passerelle appropriée.
-
Dans **Nom de la connexion**, saisissez votre nom de connexion.
-
Dans **Type de connexion**, sélectionnez **Azure Databricks**.
-
Dans Server Hostname , saisissez le hostname du warehouse Databricks SQL de SAP.
-
Dans Chemin HTTP , saisissez le chemin HTTP du SQL Warehouse.
-
Sous Authentification , spécifiez vos identifiants d'authentification.
- Dans **Méthode d’authentification**, sélectionnez **Identifiants client Databricks**.
- Dans **ID client Databricks**, saisissez l’ID client de votre Service Principal.
- Dans **Databricks Client Secret**, saisissez le secret client du Service Principal.
-
Dans **Niveau de confidentialité**, sélectionnez **Organisationnel**.
-
Cliquez sur **Créer**.
Dépannage
Erreur | Notes |
|---|---|
« Approbation requise » lors du lancement de la publication vers Power BI pour la première fois | Si vous voyez ce message, vous aurez besoin de l'approbation de l'administrateur Entra avant de pouvoir accorder des autorisations à cette fonctionnalité d'intégration. Contactez votre administrateur Entra pour approuver la demande. Suivez ce Link pour les instructions. |
PowerBINotLicensedException | Assurez-vous que vous disposez d’une licence Power BI Premium (capacité Premium, Premium par utilisateur (PPU) ou capacité Microsoft Fabric). |
Nous n'avons pas pu déployer ce dataset. Contactez un administrateur de capacité pour vous assurer que la prise en charge de la lecture/écriture XMLA est activée dans les paramètres de capacité sur la capacité Power BI Premium, puis réessayez. Pour plus d'informations, consultez la section « Prise en charge de la lecture/écriture XMLA » dans la documentation du produit. | Contactez votre administrateur de capacité Power BI pour activer les capacités de **lecture et écriture** sous le **XMLA Endpoint** dans les paramètres de capacité. Suivez ce link pour obtenir des instructions. |
La fonctionnalité d'endpoint XMLA est désactivée. Activez la fonctionnalité d'analyse dans Excel sur PowerBI.com pour activer cette fonctionnalité. | Contactez votre administrateur de capacité Power BI pour activer les capacités de **lecture et écriture** sous le **XMLA Endpoint** dans les paramètres de capacité. Suivez ce link pour obtenir des instructions. |
Capacité inactive | Votre capacité Fabric ou Power BI peut être mise en pause. Contactez votre administrateur de capacité pour vérifier l'état de la capacité. |
La base de données nommée ' | Assurez-vous que vous avez les autorisations nécessaires pour créer un modèle sémantique. Ensuite, réessayez de publier sur Power BI pour publier le modèle sémantique avec un numéro de version incrémenté. |
Vous ne pouvez pas utiliser le mode Direct Lake conjointement avec d'autres modes de stockage dans le même modèle. Le modèle composite ne prend pas en charge le mode Direct Lake. Supprimez les tables non prises en charge ou basculez-les en mode Direct Lake. | Puisque Publier dans Power BI crée un modèle sémantique avec le mode Import ou DirectQuery, il ne peut pas être utilisé pour publier dans un dataset existant qui utilise le mode Direct Lake. Veuillez suivre ce Link pour en savoir plus. |
L'utilisateur ' | Assurez-vous que vous publiez vers un workspace Power BI avec un mode de licence Premium. Vous ne pouvez pas publier vers un workspace avec un mode de licence Pro. |
Soit l'utilisateur ' | Vous pourriez avoir le rôle de visionneur dans le workspace Power BI. Vérifiez si vous disposez des autorisations nécessaires pour créer un modèle sémantique. Veuillez suivre ce link pour plus d'informations. |
« Échec de la mise à jour des informations d'identification de la source de données : [Microsoft][thriftextension] (14) Réponse inattendue du serveur lors d'une connexion HTTP : Réponse d'erreur Non autorisé/Interdit reçue, mais aucun message d'expiration de jeton n'a été reçu. » lors de la modification des informations d'identification de la source de données sur Power BI | Vérifier si votre workspace Databricks est accessible publiquement. Si votre workspace utilise Private Link ou des listes d'accès IP, alors vous devrez peut-être configurer une passerelle Power BI on-premise. |
Après qu'une tâche Power BI ou Publier dans Power BI mette à jour un modèle sémantique, le modèle reste bloqué sur Modifications en attente sans moyen de les appliquer ou de les ignorer. | Il s'agit d'une limitation de la plateforme Power BI, et non d'un problème SAP Databricks : Power BI ne traite pas les écritures de métadonnées XMLA externes lorsque le modèle est ouvert dans une session de modification, de sorte que la session de l'éditeur devient obsolète. Il n'y a pas d'API pour détecter si quelqu'un a le modèle ouvert en mode édition avant la publication. Pour effacer l'état, connectez-vous au modèle via l'Endpoint XMLA (par exemple, avec Tabular Editor) et appliquez ou annulez les modifications en attente. Pour éviter le problème, ne gardez pas de modèle sémantique ouvert pour modification pendant l'exécution d'une tâche Power BI ou d'un Job Publier dans Power BI . Si le problème persiste, contactez le support Microsoft. |