Azure Databricks

Remarque

Ce connecteur est détenu et fourni par Databricks.

Résumé

Property Valeur
Connecteur icône Azure Databricks Azure 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 Azure Active Directory
Informations d’identification du client Databricks
Jeton d’accès personnel
Authentification spécifique au produit principal de service (Power BI / Fabric)
Identité de l’espace de travail (Power BI/Fabric)
Type de source de données Databricks
Documentation de référence sur les fonctions Databricks.Catalogs
Databricks.Contents
Databricks.Query

Important

Le connecteur Azure Databricks pour Power BI prend désormais en charge le pilote Arrow Database Connectivity (ADBC). 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.

Prerequisites

Pour les réseaux privés, vous devez implémenter les paramètres réseau suivants :

  • *.blob.core.windows.net* et *.store.core.windows.net doivent être ouverts dans votre environnement réseau.
  • Cette liste de téléchargements et de révocations de certificats doit également être ajoutée à votre liste d'autorisation.
  • Si la prise en charge du pare-feu est activée sur votre compte de stockage d’espace de travail Databricks, vous devez configurer une passerelle de données de réseau virtuel ou une passerelle de données locale pour autoriser l’accès privé au compte de stockage. Cela garantit que l’service Power BI Fabric peut continuer à accéder au compte de stockage de l’espace de travail et que CloudFetch continue de fonctionner correctement. Vous pouvez également désactiver CloudFetch avec la configuration EnableQueryResultDownload=0.

Fonctionnalités prises en charge

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

Parameters

Point d’entrée :Databricks.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 Par défaut déclaré Valeurs autorisées Exemples de valeurs Pouvant être nul Optional Métadonnées de valeur autorisées Valeurs déclarées autorisées
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 le listage des tables, mais cela empêchera le pliage des requêtes 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 la détection automatique du 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": "activé"}, {"Metadata": {"Documentation.Caption": "Disabled (par défaut)", "Documentation.Name": "AutomaticProxyDiscoveryFlag.Disabled"}, "Value": "désactivé"}] ["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 pilote à utiliser. "2.0" « 2.0 » (2.0 - ADBC) ; null (valeur par défaut du système) 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

AWS, Azure ou GCP

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 sélectionner le connecteur Databricks, Azure Databricks. Utilisez le connecteur Azure Databricks pour toutes les données Databricks SQL Warehouse, sauf indication contraire de votre représentant Databricks.

    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. Il existe 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 (utilisable pour AWS, Azure ou GCP). Pour obtenir des instructions sur la génération d’un jeton d’accès personnel (PAT), consultez jetons d’accès personnels.

    • Azure Active Directory (utilisable uniquement pour Azure). 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. Pour modifier ces informations d’identification, accédez à Fichier > Options et paramètres > Paramètres de la source de données. Informations supplémentaires : 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 Azure Databricks dans l’expérience obtenir 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 les connecteurs Databricks disponibles à l'aide du champ de recherche. Utilisez le connecteur Azure Databricks pour toutes les données Databricks SQL Warehouse, sauf indication contraire de votre représentant Databricks.

    Screenshot des options du connecteur 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.

    Screenshot des paramètres et informations d’identification de connexion pour Azure Databricks.

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

    • Informations d’identification du client Databricks. Pour obtenir des instructions sur la génération des informations d’identification du client Databricks OAuth M2M, consultez Databricks OAuth M2M.
    • Jeton d’accès personnel (utilisable pour AWS, Azure ou GCP). Reportez-vous à jetons d’accès personnels pour obtenir des instructions sur la génération d’un jeton d’accès personnel (PAT).
    • Azure Active Directory (utilisable uniquement pour Azure). Connectez-vous à votre compte professionnel à l’aide de la fenêtre contextuelle du navigateur.
    • Principal de service (utilisable uniquement pour Azure). Authentifiez-vous auprès d’un principal de service Microsoft Entra ID. Cette option est disponible lors de la configuration d’une connexion cloud ou de passerelle.
  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

Vous pouvez utiliser le pilote Arrow Database Connectivity (ADBC) pour le connecteur Azure Databricks dans Power BI. À mesure que nous continuons à améliorer et à ajouter de nouvelles fonctionnalités à ce connecteur, nous vous recommandons de procéder à une mise à niveau vers la dernière version pour l’essayer et envoyer des commentaires sur le produit.

Remarque

Depuis février 2026, les nouvelles connexions créées dans Power BI Desktop ou le service Power BI utilisent automatiquement le pilote ADBC (Arrow Database Connectivity) par défaut. Les connexions existantes continueront d’utiliser ODBC, sauf si vous les mettez manuellement à jour vers ADBC.

Pour basculer vers le driver 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 = Databricks.Catalogs("adb-<workspace-id>.<random-number>.azuredatabricks.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
    

Limitations et considérations

  • Le connecteur Azure Databricks prend en charge proxy web. Toutefois, les paramètres de proxy automatique définis dans les fichiers .pac ne sont pas pris en charge.
  • Dans le connecteur Azure Databricks, la source de données Databricks.Query n'est pas prise en charge avec le mode DirectQuery du modèle sémantique Power BI.