Aller au contenu principal

Connecter Power BI en tant que source de connaissances externe

info

Bêta

Cette fonctionnalité est en version bêta. Pour l'utiliser, un administrateur de compte doit activer les connaissances externes à partir de la page Aperçus de la console de compte. Consultez Gérer les aperçus au niveau du compte.

Databricks peut extraire les métadonnées des modèles sémantiques Power BI afin que Genie puisse utiliser vos définitions de mesures Power BI lorsqu’il répond aux questions. Power BI est une source de connaissances externe.

Avant de commencer​

La configuration de Power BI en tant que source de connaissances externe implique Power BI et Databricks. Chaque partie de la configuration nécessite des permissions différentes.

important

Lorsque l'aperçu des connaissances externes est activé, Databricks récupère les métadonnées via chaque connexion Power BI dans Unity Catalog qui utilise OAuth Machine to Machine et qui est utilisée par une tâche Power BI, y compris les connexions et tâches existantes. Les extraits d'ontologie créés à partir de ces métadonnées sont disponibles pour tous les utilisateurs de votre compte Databricks, quel que soit leur accès dans Power BI. Pour limiter ce que Databricks récupère, ajoutez le Service Principal de chaque connexion uniquement aux Workspace Power BI que vous souhaitez inclure.

Configuration requise pour Power BI​

Le Service Principal de la connexion Power BI doit être ajouté directement à chaque workspace Power BI duquel vous souhaitez extraire des métadonnées, avec au moins le rôle Contributeur . Il n’est pas nécessaire de l’ajouter à d’autres Workspace. Voir Donner aux utilisateurs l’accès aux Workspace.

Configuration requise pour Databricks​

Pour créer la connexion Power BI et extraire les métadonnées, vous avez besoin des éléments suivants :

Créer la connexion et exécuter la tâche Power BI​

Si vous avez déjà une tâche Power BI qui utilise une connexion Power BI avec OAuth Machine à Machine, vous n'avez pas besoin de créer une nouvelle connexion ou tâche. Databricks start à extraire les métadonnées lors de la prochaine exécution de la tâche après l'activation de la préversion Connaissances externes . Vérifiez que le Service Principal de la connexion respecte les exigences de Power BI.

Sinon, créez une connexion Power BI dans Unity Catalog qui utilise OAuth Machine to Machine, puis exécutez une tâche Power BI qui utilise la connexion :

  1. Créez une connexion Power BI dans Unity Catalog qui stocke les informations d’identification du Service Principal de Microsoft Entra. Suivez les étapes décrites dans Créer une connexion Power BI dans Unity Catalog pour l’orchestration, et effectuez les actions suivantes :

    • Pour le type d’auth , sélectionnez OAuth machine à machine .
    • Pour les informations d’identification, saisissez l’ID client, le secret client et l’ID du tenant de Microsoft Entra.
  2. Ajoutez une tâche Power BI à un job, sélectionnez la connexion pour cette tâche et exécutez le job. Voir Configurer une tâche Power BI.

La première fois que la tâche s’exécute, Databricks start à récupérer les métadonnées par le biais de la connexion. Lorsque Genie utilise un extrait créé à partir des métadonnées de Power BI pour répondre à une question, l’extrait apparaît dans les citations de la réponse.

Comment Databricks extrait les métadonnées Power BI​

Databricks lit les métadonnées de Power BI via les connexions Power BI dans Unity Catalog. Les sections suivantes décrivent quelles métadonnées Databricks extrait, quelle API et quelles connexions il utilise, et comment fonctionne l’accès aux données pour les extraits d’ontologie créés à partir de celles-ci.

Quelles métadonnées Databricks récupère​

Databricks récupère les métadonnées suivantes à partir de vos Workspace Power BI :

  • Modèles sémantiques : tables, colonnes, types de données et mode de stockage.
  • Logique de mesure et de query : formules de mesure DAX, colonnes calculées et expressions Power Query (M).
  • Configuration du modèle : la Layout du diagramme du modèle sémantique.

Les extraits d'ontologie n'incluent pas les éléments suivants :

  • Définitions des rôles et membres de la sécurité au niveau des lignes (RLS).
  • Adresses e-mail des propriétaires d'assets Power BI.

API, portée et refresh​

Databricks utilise la connexion Power BI dans Unity Catalog pour lire la définition de chaque modèle sémantique avec l’API REST Fabric Get Semantic Model Definition.

Pour chaque connexion, Databricks extrait les métadonnées des Workspace Power BI auxquelles le Service Principal de la connexion peut accéder.

Databricks refresh ces métadonnées tous les 7 jours. Les métadonnées restent dans la région de votre workspace et ne sont pas visibles en tant que table Unity Catalog.

Extraits d'ontologie et accès aux données​

Les extraits d'ontologie contiennent des métadonnées, telles que des définitions de mesures et des relations, et non les données de vos tables. Les autorisations Unity Catalog régissent toujours l'accès à ces données. Les utilisateurs qui n'ont pas accès aux tables Unity Catalog auxquelles un extrait fait référence ne peuvent pas query ces tables par le biais de Genie.

Si un asset Power BI est supprimé, ou si le Service Principal de la connexion ne peut plus y accéder, Genie cesse d'utiliser les extraits créés à partir de cet asset.

Limitations​

  • Databricks crée des extraits d’ontologie uniquement pour les modèles sémantiques Power BI qui lisent les données des objets Unity Catalog.
  • Databricks ne capture pas l'activité d'utilisation, telle que les vues de rapport.
  • Vous ne pouvez pas limiter les extraits d’ontologie à des utilisateurs ou des groupes spécifiques. Pour arrêter de les diffuser, un administrateur de compte peut désactiver l’aperçu Connaissances externes .

Ressources supplémentaires​