Configurez le driver ADBC ou ODBC pour Power BI.

info

Aperçu

Cette fonctionnalité est en Aperçu public.

Les connexions Power BI à Databricks utilisent l'un des deux drivers suivants : Arrow Database Connectivity (ADBC) ou Open Database Connectivity (ODBC). Arrow Database Connectivity (ADBC) est le default pour toutes les nouvelles connexions Power BI créées dans l’interface utilisateur, mais les connexions préexistantes continuent d’utiliser ODBC, sauf si vous les mettez à jour manuellement. Cette page explique comment basculer une connexion entre les deux drivers.

Le driver Arrow Database Connectivity (ADBC) est une norme API moderne et en colonnes, conçue pour les applications analytiques, permettant un transfert de données efficace entre les bases de données et les outils clients à l'aide du format Apache Arrow. Pour les dernières mises à jour du Driver ADBC, consultez le journal des modifications.

Pour utiliser le Driver ADBC, utilisez Power BI Desktop 2.145.1105.0 ou une version ultérieure.

important

Power BI prévoit de faire passer toutes les connexions Power BI vers ADBC. Databricks recommande de passer à ADBC et de le tester dès maintenant afin de fournir des commentaires et d'aider à garantir une migration sans disruption. Pour connaître le calendrier de transition et les options de migration de Microsoft, consultez Transition from ODBC to ADBC drivers.

remarque

Vous devez utiliser un seul type de Driver par modèle sémantique. Configurez chaque connexion Databricks au sein d'un modèle sémantique en ADBC ou en ODBC.

Databricks continue d'améliorer ce connecteur et d'ajouter de nouvelles fonctionnalités. Mettez à niveau vers la dernière version, essayez-la, et soumettez vos commentaires sur le produit.

Basculer les connexions existantes vers ADBC

Certaines connexions Power BI existantes continuent d'utiliser le Driver ODBC, à moins que vous ne les mettiez à jour manuellement. Vous pouvez faire passer des tableaux de bord individuels à l'utilisation d'ADBC en modifiant l'implémentation.

Pour basculer une connexion existante vers le Driver ADBC pour un tableau de bord spécifique :

Ouvrez le tableau de bord souhaité dans Power BI.
Click convertir des données, transformer des données .
Cliquez sur Éditeur avancé dans la section des options de Query .

Spécifiez Implementation="2.0" pour passer au Driver ADBC.

let
    Source = DatabricksMultiCloud.Catalogs("<instance-name>.cloud.databricks.net", "/sql/1.0/warehouses/<sql-warehouse-id>",
     [Catalog=null, Database=null, EnableAutomaticProxyDiscovery=null, Implementation="2.0"]),
    powerbi_Database = Source{[Name="powerbi",Kind="Database"]}[Data],
    default_Schema = powerbi_Database{[Name="default",Kind="Schema"]}[Data],
    dashboard_data_Table = default_Schema{[Name="dashboard_data",Kind="Table"]}[Data]
in
    dashboard_data_Table

Se connecter à un warehouse Lakehouse//RT

Lakehouse//RT (Bêta) accepte uniquement les connexions utilisant l’ API Statement Execution, un chemin d’exécution basé sur REST. Il ne prend pas en charge l’ancien protocole Thrift sur lequel repose le driver ODBC ; vous devez donc utiliser le driver ADBC.

Assurez-vous de respecter les exigences suivantes lors de la connexion depuis Power BI :

Pour Power BI Desktop , la connexion à Lakehouse//RT nécessite Power BI Desktop v2.156.951.0 (juillet 2026) ou une version ultérieure.
Dans le service Power BI , la connexion à Lakehouse//RT avec le connecteur Databricks échoue, car le service teste les connexions via ODBC, quel que soit le driver que vous configurez. En guise de solution de contournement, utilisez plutôt le connecteur Azure Databricks . Vous pouvez utiliser le connecteur Azure Databricks avec un workspace Databricks sur n’importe quel cloud en vous authentifiant avec un jeton d’accès personnel (PAT) ou un Service Principal.

Pour connaître les queries, les types de tables et les fonctionnalités Databricks pris en charge par Lakehouse//RT, consultez Lakehouse Real-Time.

Créer une nouvelle connexion à Lakehouse//RT

Pour connecter Power BI Desktop ou le service Power BI à un warehouse Lakehouse//RT :

Obtenez le Hostname du serveur et le chemin HTTP de votre warehouse Lakehouse//RT.
Connectez-vous au warehouse depuis Power BI en suivant les étapes de connexion pour Power BI Desktop ou le service Power BI. Sous Options avancées , définissez les deux options suivantes :
- Pour Implementation , sélectionnez 2.0 - ADBC , qui utilise le driver ADBC.
- Pour Protocol , sélectionnez REST(SEA) , qui achemine les requêtes via l'API Statement Execution.

Basculer les connexions existantes vers Lakehouse//RT

Pour mettre à jour une connexion existante afin d'utiliser un Lakehouse//RT warehouse, modifiez la query pour cibler cet warehouse et utilisez le ADBC Driver avec le protocole REST :

Ouvrez le tableau de bord souhaité dans Power BI.
Click convertir des données, transformer des données .
Cliquez sur Éditeur avancé dans la section des options de Query .

Définissez le chemin HTTP de l' warehouse sur votre entrepôt Lakehouse//RT, puis spécifiez Implementation="2.0" pour utiliser le Driver ADBC et Protocol="rest" pour acheminer les query via l'API Statement Execution.

let
    Source = Databricks.Catalogs("<server-hostname>", "/sql/1.0/warehouses/<sql-warehouse-id>",
     [Catalog=null, Database=null, QueryTags=null, EnableAutomaticProxyDiscovery="enabled", Implementation="2.0", Protocol="rest"]),
    #"Navigation 1" = Source{[Name="<catalog>", Kind="Database"]}[Data],
    #"Navigation 2" = #"Navigation 1"{[Name="<schema>", Kind="Schema"]}[Data],
    #"Navigation 3" = #"Navigation 2"{[Name="<table>", Kind="Table"]}[Data]
in
    #"Navigation 3"

Revenir à ODBC

Si vous préférez utiliser l'ODBC au lieu de l'ADBC pour les nouvelles connexions, vous avez deux options :

Si vous souhaitez utiliser le driver ODBC pour une connexion spécifique dans Power BI Desktop ou Power BI Service, sélectionnez default comme implémentation .
Si vous souhaitez continuer à utiliser le Driver ODBC pour toutes les nouvelles connexions dans Power BI, désactivez la préversion de la fonctionnalité ADBC pour restaurer l'ODBC dans Power BI Desktop.

Pour utiliser le driver ODBC pour toutes les nouvelles connexions :

Dans Power BI pour ordinateur de bureau, cliquez sur Fichier > Options et paramètres > Options .
Cliquez sur l'**Aperçu des fonctionnalités**.
Désactivez Utiliser les nouvelles implémentations de connecteur Databricks .

Si vous souhaitez configurer une connexion spécifique pour utiliser le driver ODBC, définissez default comme Implémentation . Voir les étapes décrites dans Basculer les connexions existantes vers ADBC.

Ressources supplémentaires

Configurer le SSO Microsoft Entra ID pour Power BI.

Basculer les connexions existantes vers ADBC​

Se connecter à un warehouse Lakehouse//RT​

Créer une nouvelle connexion à Lakehouse//RT​

Basculer les connexions existantes vers Lakehouse//RT​

Revenir à ODBC​

Ressources supplémentaires​