Azure Databricks

Annotazioni

Questo connettore è di proprietà e fornito da Databricks.

Riassunto

Property Value
Connettore icona Azure Databricks Azure Databricks
Prodotti Power BI (modelli semantici)
Power Query Online
Stato di rilascio Disponibilità generale
Category Database
Tipi di autenticazione Azure Active Directory
Credenziali client di Databricks
Token di accesso personale
Autenticazione specifica del prodotto entità servizio (Power BI / Fabric)
Identità del workspace (Power BI / Fabric)
Tipo di origine dati Databricks
Documentazione di riferimento sulle funzioni Databricks.Catalogs
Databricks.Contents
Databricks.Query

Importante

Il connettore Azure Databricks per Power BI supporta ora il driver Arrow Database Connectivity (ADBC). Questo connettore passa dal driver ODBC Di Simba Spark incorporato al driver ADBC di Databricks. Per indicazioni sulla migrazione, date chiave e controlli di amministrazione, vedere Transition da ODBC a driver ADBC in Power BI e Fabric.

Prerequisites

Per le reti private, è necessario implementare le impostazioni di rete seguenti:

  • *.blob.core.windows.net* e *.store.core.windows.net devono essere aperti nell'ambiente di rete.
  • Questo elenco di download e revoche di certificati deve anche essere aggiunto all'elenco di elementi consentiti.
  • Se il supporto del firewall è abilitato nell'account di archiviazione dell'area di lavoro di Databricks, è necessario configurare un gateway dati di rete virtuale o un gateway dati locale per consentire l'accesso privato all'account di archiviazione. In questo modo, il servizio Fabric Power BI può continuare ad accedere all'account di archiviazione dell'area di lavoro e CloudFetch continua a funzionare correttamente. In alternativa, è possibile disabilitare CloudFetch con la configurazione EnableQueryResultDownload=0.

Funzionalità supportate

  • Importazione
  • DirectQuery (modelli semantici Power BI)

Parameters

Punto di ingresso:Databricks.Catalogs

Numero di parametri obbligatori: 2

Parametro Nome visualizzato Obbligatorio Type Group Descrizione Valori di esempio Annulabile
host Nome host del server Sì text Nome host del server Databricks. "example.azuredatabricks.net" false
httpPath Percorso HTTP Sì text Percorso HTTP del cluster. "/sql/1.0/warehouses/abcdef1234567890" false
options Opzioni avanzate No record nullable Opzioni avanzate true

Campi in options

Field Nome visualizzato Obbligatorio Type Group Descrizione Predefinito dichiarato Valori consentiti Valori di esempio Annulabile Optional Metadati dei valori consentiti Valori consentiti definiti
opzioni.Catalogo Catalogo predefinito No text Opzioni avanzate Selezionare un catalogo predefinito per la connessione. false true
options.Database Database No text Opzioni avanzate Limitare la connessione al database selezionato. Ciò potrebbe rendere più veloce l'elenco delle tabelle, ma impedirà il query folding per le query che raggiungono più database diversi. false true
options.QueryTags Tag delle query No text Opzioni avanzate Tag chiave-valore per il rilevamento delle query nella tabella system.query.history. "tag1:value1,tag2:value2" false true
options.EnableAutomaticProxyDiscovery Individuazione automatica del proxy No text Opzioni avanzate Questo consente il rilevamento automatico del proxy a livello di sistema di Windows. "enabled" (Enabled); "disabled" (Disabilitato (impostazione predefinita)) false true [{"Metadata": {"Documentation.Caption": "Enabled", "Documentation.Name": "AutomaticProxyDiscoveryFlag.Enabled"}, "Value": "enabled"}, {"Metadata": {"Documentation.Caption": "Disabled (default)", "Documentation.Name": "AutomaticProxyDiscoveryFlag.Disabled"}, "Value": "disabled"}] ["attivato", "disattivato"]
options.Implementation Implementation No text Opzioni avanzate Usare '2.0 (beta)' per specificare ADBC. Il valore 'default' userà la configurazione dell'ambiente per determinare il driver da usare. "2.0" "2.0" (2.0 - ADBC); null (impostazione predefinita del sistema) false true ["2.0", null]
options.Protocol Protocol No text Opzioni avanzate Specifica il protocollo utilizzato dal driver ADBC. Selezionare "REST (SEA)" per usare l'API di esecuzione dell'istruzione. Se non è impostata, viene usato il valore predefinito del driver (Thrift). Null null (impostazione predefinita); "rest" (REST (SEA)) false true [null, "rest"]

Connettersi da Power Query Desktop

AWS, Azure o GCP

Per connettersi a Databricks da Power Query Desktop, seguire questa procedura:

  1. Nell'esperienza Recupera dati, cerca Databricks per selezionare il connettore Databricks, Azure Databricks. Usare il connettore Azure Databricks per tutti i dati di Databricks SQL Warehouse, a meno che non sia stato specificato diversamente dal repository Databricks.

    Screenshot della finestra di dialogo Recupera dati per Databricks Cloud.

  2. Fornisci il nome host del Server e il percorso HTTP per il tuo Databricks SQL Warehouse. Fare riferimento a Configurare i driver ODBC e JDBC di Databricks per istruzioni su come trovare "Nome host server" e "Percorso HTTP". Inserire queste informazioni di conseguenza. Facoltativamente, è possibile specificare un catalogo predefinito e/o un database in Opzioni avanzate. Seleziona OK per continuare.

    Screenshot dei campi di connessione di Databricks SQL Warehouse.

  3. Specificare le credenziali per l'autenticazione con Databricks SQL Warehouse. Sono disponibili tre opzioni per le credenziali:

    • Credenziali client di Databricks. Vedere Databricks OAuth M2M per istruzioni sulla generazione di credenziali client OAuth M2M di Databricks.

    • Personal Access Token (utilizzabile per AWS, Azure o GCP). Per istruzioni sulla generazione di un token di accesso personale, vedere Token di accesso personali.

    • Azure Active Directory (utilizzabile solo per Azure). Accedere all'account aziendale usando il popup del browser.

      Schermata del campo di inserimento del token di Databricks.

    Annotazioni

    Dopo aver immesso le credenziali per un determinato Databricks SQL Warehouse, Power BI Desktop memorizza nella cache e riutilizza le stesse credenziali nei tentativi di connessione successivi. Per modificare tali credenziali, vai a File > Opzioni e impostazioni > Impostazioni origine dati. Altre informazioni: Modificare il metodo di autenticazione

  4. Una volta che ti connetti con successo, il navigatore mostra i dati disponibili a te sul cluster. È possibile scegliere Transform Data per trasformare i dati usando Power Query o Load per caricare i dati in Power Query Desktop.

    Immagine del navigatore di Power Query che carica i dati di Databricks Cloud nell'app desktop.

Connettersi da Power Query Online

Per connettersi a Databricks da Power Query Online, seguire questa procedura:

  1. Selezionare l'opzione Azure Databricks nell'esperienza di recupero dei dati. Diverse app hanno diversi modi per accedere all'esperienza dei dati Power Query Online. Per altre informazioni su come accedere all'esperienza di Power Query Online per ottenere dati dall'app, passare a Where per ottenere dati.

    Seleziona i connettori di Databricks disponibili utilizzando la casella di ricerca. Usare il connettore Azure Databricks per tutti i dati di Databricks SQL Warehouse, a meno che non sia stato specificato diversamente dal repository Databricks.

    Screenshot delle opzioni del connettore Databricks in Power Query.

  2. Immettere il nome host del server e il percorso HTTP per il Databricks SQL Warehouse. Fare riferimento a Configurare i driver ODBC e JDBC di Databricks per istruzioni su come trovare "Nome host server" e "Percorso HTTP". Facoltativamente, è possibile specificare un catalogo predefinito e/o un database in Opzioni avanzate.

    Screenshot delle impostazioni di connessione e delle credenziali per Azure Databricks.

  3. Specificare le credenziali per l'autenticazione con Databricks SQL Warehouse. Ci sono quattro opzioni per le credenziali:

    • Credenziali client di Databricks. Per istruzioni su come generare le credenziali client Databricks OAuth M2M, vedi Databricks OAuth M2M.
    • Personal Access Token (utilizzabile per AWS, Azure o GCP). Fare riferimento a token di accesso personali per istruzioni sulla generazione di un token di accesso personale (PAT).
    • Azure Active Directory (utilizzabile solo per Azure). Accedere all'account aziendale usando il popup del browser.
    • Service principal (utilizzabile solo per Azure). Autentica con un principio di servizio Microsoft Entra ID. Questa opzione è disponibile durante la configurazione di una connessione cloud o gateway.
  4. Una volta stabilita con successo la connessione, lo strumento di navigazione appare e mostra i dati disponibili sul server. Selezionare i dati nello strumento di navigazione. Selezionare quindi Avanti per trasformare i dati in Power Query.

    Screenshot dello strumento di navigazione Power Query che carica i dati di Databricks Cloud nell'app online.

Informazioni aggiuntive

Implementazione del connettore del driver Arrow Database Connectivity

È possibile usare il driver Arrow Database Connectivity (ADBC) per il connettore Azure Databricks in Power BI. Man mano che continuiamo a migliorare e aggiungere nuove funzionalità a questo connettore, ti consigliamo di eseguire l'aggiornamento alla versione più recente per provarlo e inviare commenti e suggerimenti sul prodotto.

Annotazioni

A partire da febbraio 2026, le nuove connessioni create in Power BI Desktop o nel servizio Power BI useranno automaticamente il driver Arrow Database Connectivity (ADBC) per impostazione predefinita. Le connessioni esistenti continueranno a usare ODBC a meno che non vengano aggiornate manualmente ad ADBC.

Per passare al driver ADBC:

  1. Aprire il dashboard desiderato in Power BI.
  2. Selezionare Trasforma dati.
  3. Selezionare Editor avanzato nella sezione opzione Query.
  4. Specificare Implementation="2.0" per 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
    

Limitazioni e considerazioni

  • Il connettore Azure Databricks supporta web proxy. Tuttavia, le impostazioni proxy automatiche definite nei file con estensione pac non sono supportate.
  • Nel connettore Azure Databricks, l'origine dati Databricks.Query non è supportata in combinazione con la modalità DirectQuery del modello semantico di Power BI.