Databricks

Nota

Questo connettore è di proprietà e fornito da Databricks.

Sommario

Property	Value
Connettore	Databricks
Prodotti	Power BI (modelli semantici) Power Query Online
Stato di rilascio	Disponibilità generale
Category	Database
Tipi di autenticazione	Credenziali client di Databricks OAuth (OIDC) Token di accesso personale
Tipo di origine dati	DatabricksMultiCloud
Documentazione di riferimento sulle funzioni	DatabricksMultiCloud.Catalogs DatabricksMultiCloud.Query

Nota

Alcune funzionalità potrebbero essere presenti in un prodotto, ma non altre a causa di pianificazioni della distribuzione e funzionalità specifiche dell'host.

Importante

Il connettore 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.

Prerequisiti

Questo connettore è utilizzabile solo con un Databricks SQL Warehouse in esecuzione su AWS e che utilizza OAuth. Se si usa Azure Databricks, usare il connettore Azure Databricks. Se non si usa OAuth con databricks SQL Warehouse (in AWS o GCP), usare anche il connettore Azure Databricks. La Databricks Community Edition non è supportata.

Funzionalità supportate

• Importazione
• DirectQuery (modelli semantici Power BI)

Parameters

Punto di ingresso:DatabricksMultiCloud.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 dichiarati
options.Catalog	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	In questo modo è possibile abilitare il rilevamento automatico del proxy a livello di sistema in Windows.		"enabled" (Abilitato); "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"}]	["enabled", "disabled"]
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 la Statement Execution API. 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

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

1. Nell'esperienza Get Data, cercare Databricks per selezionare il connettore Databricks. Dovresti usare il connettore Databricks solo qui per i dati del Databricks SQL Warehouse (in esecuzione su AWS) se utilizzi OAuth per l'autenticazione.

   

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. Selezionare OK per continuare.

   

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.

   • Token di accesso personale. Fare riferimento a token di accesso personali per istruzioni sulla generazione di un token di accesso personale (PAT).

   • OAuth (OIDC). Accedere all'account aziendale usando il popup del browser.

     

   Nota

   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.

   

Connettersi da Power Query Online

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

1. Selezionare l'opzione Databricks nell'acquisizione 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.

   Elenca i connettori Databricks disponibili utilizzando la casella di ricerca. Selezionare il connettore Databricks per il Databricks SQL Warehouse.

   

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.

   

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

   • Basico. Usare questa opzione quando si esegue l'autenticazione con un nome utente e una password. Questa opzione non è disponibile se l'organizzazione o l'account usa 2FA/MFA.
   • Chiave dell'account. Usare questa opzione quando si esegue l'autenticazione con un token di accesso personale. Fare riferimento a token di accesso personali per istruzioni sulla generazione di un token di accesso personale (PAT).
   • Account organizzativo. Usare questa opzione per l'autenticazione con OAuth. Accedere all'account aziendale usando il popup del browser.

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.

   

Informazioni aggiuntive

Implementazione del connettore del driver di connettività al database Arrow

È possibile usare il driver Arrow Database Connectivity (ADBC) per il connettore 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.

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 = 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