Databricks

Remarque

Ce connecteur est détenu et fourni par Databricks.

Résumé

Property Valeur
Connecteur Icône Databricks Databricks
Produits Power BI (modèles sémantiques)
Power Query Online
État de mise en production Disponibilité générale
Category Database
Types d’authentification Informations d’identification du client Databricks
OAuth (OIDC)
Jeton d’accès personnel
Type de source de données DatabricksMultiCloud
Documentation de référence sur les fonctions DatabricksMultiCloud.Catalogs
DatabricksMultiCloud.Query

Remarque

Certaines fonctionnalités peuvent être présentes dans un produit, mais pas d’autres en raison de planifications de déploiement et de fonctionnalités spécifiques à l’hôte.

Important

Le pilote ADBC (Arrow Database Connectivity) pour le connecteur Databricks dans Power BI est généralement disponible à compter du 15 octobre 2026. Ce connecteur passe du pilote ODBC Simba Spark incorporé au pilote Databricks ADBC. Pour obtenir des conseils de migration, des dates clés et des contrôles d’administration, consultez Transition d’ODBC vers les pilotes ADBC dans Power BI et Fabric.

Conditions préalables

Ce connecteur est uniquement utilisé avec un Databricks SQL Warehouse s’exécutant sur AWS et à l’aide d’OAuth. Si vous utilisez Azure Databricks, utilisez le connecteur Azure Databricks. Si vous n'utilisez pas OAuth avec votre databricks SQL Warehouse (sur AWS ou GCP), utilisez également le connecteur Azure Databricks. Databricks Community Edition n’est pas pris en charge.

Fonctionnalités prises en charge

  • Importer
  • DirectQuery (modèles sémantiques Power BI)

Parameters

Point d’entrée :DatabricksMultiCloud.Catalogs

Nombre de paramètres requis : 2

Parameter Nom d'affichage Required Type Group Descriptif Exemples de valeurs Pouvant être nul
host Nom d’hôte du serveur Yes texte Nom d’hôte du serveur Databricks. « example.azuredatabricks.net » false
httpPath Chemin HTTP Yes texte Chemin d’accès HTTP du cluster. « /sql/1.0/warehouses/abcdef1234567890 » false
options Options avancées No Enregistrement annulable Options avancées true

Champs dans options

Champ Nom d'affichage Required Type Group Descriptif Défaut déclaré Valeurs autorisées Exemples de valeurs Pouvant être nul Optional Métadonnées de valeur autorisées Valeurs autorisées définies
options.Catalog Catalogue par défaut No texte Options avancées Sélectionnez un catalogue par défaut pour la connexion. false true
options.Base de données Database No texte Options avancées Limitez la connexion à la base de données sélectionnée. Cela peut accélérer la liste des tables, mais cela empêchera le repliement de requête pour les requêtes qui atteignent plusieurs bases de données différentes. false true
options.QueryTags Balises de requête No texte Options avancées Balises clé-valeur pour le suivi des requêtes dans la table system.query.history. "tag1:value1,tag2:value2" false true
options.EnableAutomaticProxyDiscovery Détection automatique du proxy No texte Options avancées Cela permet de détecter automatiquement le proxy à l’échelle du système Windows. « activé » (activé) ; « désactivé » (Désactivé (par défaut)) false true [{"Metadata": {"Documentation.Caption": "Activé", "Documentation.Name": "AutomaticProxyDiscoveryFlag.Enabled"}, "Value": "enabled"}, {"Metadata": {"Documentation.Caption": "Disabled (par défaut)", "Documentation.Name": "AutomaticProxyDiscoveryFlag.Disabled"}, "Value": "disabled"}] ["activé", "désactivé"]
options.Implementation Implementation No texte Options avancées Utilisez « 2.0 (bêta) » pour spécifier ADBC. La valeur « par défaut » utilise la configuration de l’environnement pour déterminer le driver à utiliser. "2.0" « 2.0 » (2.0 - ADBC) ; null (valeur système par défaut) false true ["2.0", null]
options.Protocole Protocol No texte Options avancées Spécifie le protocole utilisé par le pilote ADBC. Sélectionnez « REST (SEA) » pour utiliser l’API Statement Execution. Lorsqu’il n’est pas défini, le pilote par défaut (Thrift) est utilisé. zéro null (valeur par défaut); « rest » (REST (SEA)) false true [null, "rest"]

Se connecter à partir de Power Query Desktop

Pour vous connecter à Databricks à partir de Power Query Desktop, procédez comme suit :

  1. Dans l’expérience Obtenir des données, recherchez Databricks pour dresser une liste restreinte du connecteur Databricks. Vous devez uniquement utiliser le connecteur Databricks ici pour vos données Databricks SQL Warehouse (exécutées sur AWS) si vous utilisez OAuth pour l’authentification.

    Capture d’écran de la boîte de dialogue Obtenir des données pour Databricks Cloud.

  2. Fournissez le nom d’hôte du serveur et le chemin HTTP pour votre Databricks SQL Warehouse. Reportez-vous à Configurer les pilotes ODBC et JDBC Databricks pour obtenir des instructions pour rechercher votre « nom d’hôte serveur » et votre « chemin HTTP ». Entrez ces informations en conséquence. Vous pouvez éventuellement fournir un catalogue et/ou une base de données par défaut sous options avancées. Sélectionnez OK pour continuer.

    Capture d’écran des champs de connexion Databricks SQL Warehouse.

  3. Fournissez vos informations d’identification pour vous authentifier auprès de votre Databricks SQL Warehouse. Vous avez trois options pour les informations d’identification :

    • Informations d’identification du client Databricks. Reportez-vous à Databricks OAuth M2M pour obtenir des instructions sur la génération des informations d’identification du client Databricks OAuth M2M.

    • Jeton d’accès personnel. Reportez-vous à jetons d’accès personnels pour obtenir des instructions sur la génération d’un jeton d’accès personnel (PAT).

    • OAuth (OIDC). Connectez-vous à votre compte professionnel à l’aide de la fenêtre contextuelle du navigateur.

      Capture d’écran du champ d’entrée de jeton Databricks.

    Remarque

    Une fois que vous avez entré vos informations d’identification pour un Databricks SQL Warehouse particulier, Power BI Desktop met en cache et réutilise ces mêmes informations d’identification lors des tentatives de connexion suivantes. Vous pouvez modifier ces informations d'identification en accédant à Fichier > Options et paramètres > Paramètres de source de données. Plus d’informations : Modifier la méthode d’authentification

  4. Une fois que vous vous connectez, le navigateur affiche les données disponibles sur le cluster. Vous pouvez choisir Transform Data pour transformer les données à l’aide de Power Query ou Load pour charger les données dans Power Query Desktop.

    Image du Navigateur Power Query chargeant les données Databricks Cloud dans l'application de bureau.

Se connecter à partir de Power Query Online

Pour vous connecter à Databricks à partir de Power Query Online, procédez comme suit :

  1. Sélectionnez l’option Databricks dans l’expérience de récupération des données. Différentes applications ont différentes manières d'accéder à l'expérience d'acquisition de données dans Power Query Online. Pour plus d’informations sur la façon d’accéder à l'expérience de collecte de données de Power Query Online depuis votre application, rendez-vous à Où obtenir des données.

    Sélectionnez le connecteur Databricks disponible avec la barre de recherche. Sélectionnez le connecteur Databricks pour votre databricks SQL Warehouse.

    Screenshot des options de connecteurs Databricks dans Power Query.

  2. Entrez le nom d’hôte Server et le chemin HTTP pour votre Databricks SQL Warehouse. Reportez-vous à Configurer les pilotes ODBC et JDBC Databricks pour obtenir des instructions pour rechercher votre « nom d’hôte serveur » et votre « chemin HTTP ». Vous pouvez éventuellement fournir un catalogue et/ou une base de données par défaut sous options avancées.

    Capture d'écran des paramètres de connexion et des informations d’identification pour les services en ligne Databricks.

  3. Fournissez vos informations d’identification pour vous authentifier auprès de votre Databricks SQL Warehouse. Il existe trois options pour les informations d’identification :

    • Basique. Utilisez cette option lors de l’authentification avec un nom d’utilisateur et un mot de passe. Cette option n’est pas disponible si votre organisation/compte utilise 2FA/MFA.
    • Clé de compte. Utilisez cette option lors de l’authentification à l’aide d’un jeton d’accès personnel. Reportez-vous à jetons d’accès personnels pour obtenir des instructions sur la génération d’un jeton d’accès personnel (PAT).
    • Compte d’organisation. Utilisez cette option lors de l’authentification avec OAuth. Connectez-vous à votre compte professionnel à l’aide de la fenêtre contextuelle du navigateur.
  4. Une fois que vous vous connectez, le navigateur apparaît et affiche les données disponibles sur le serveur. Sélectionnez vos données dans le navigateur. Sélectionnez ensuite Next pour transformer les données dans Power Query.

    Capture d'écran du navigateur Power Query chargeant les données Databricks Cloud dans une application en ligne.

Informations supplémentaires

Implémentation du connecteur du pilote Arrow de connectivité aux bases de données

Le pilote ADBC (Arrow Database Connectivity) pour le connecteur Databricks dans Power BI est généralement disponible à compter du 15 octobre 2026. Pour l’utiliser dans Power BI Desktop, mettez à jour vers la dernière version. Vous pouvez également envoyer des commentaires sur le produit à Databricks.

Pour changer vers le pilote ADBC :

  1. Ouvrez votre tableau de bord souhaité dans Power BI.

  2. Sélectionnez Transformer les données.

  3. Sélectionnez Éditeur avancé dans la section de l’option Query.

  4. Spécifiez Implementation="2.0" pour 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