Databricks

Notitie

Deze connector is eigendom van en wordt geleverd door Databricks.

Samenvatting

Property	Value
Connector	Databricks
Producten	Power BI (semantische modellen) Power Query Online
Releasefase	Algemene beschikbaarheid
Categorie	Database
Verificatietypen	Databricks-klantreferenties OAuth (OIDC) Persoonlijk toegangstoken
Soort gegevensbron	DatabricksMultiCloud
Documentatie voor functiereferenties	DatabricksMultiCloud.Catalogs DatabricksMultiCloud.Query

Notitie

Sommige mogelijkheden zijn mogelijk aanwezig in één product, maar niet in andere vanwege implementatieschema's en hostspecifieke mogelijkheden.

Important

De Databricks-connector voor Power BI ondersteunt nu het stuurprogramma Arrow Database Connectivity (ADBC). Deze connector gaat over van het ingesloten Simba Spark ODBC-stuurprogramma naar het Databricks ADBC-stuurprogramma. Zie Transition van ODBC naar ADBC-stuurprogramma's in Power BI en Fabric voor migratierichtlijnen, sleuteldatums en beheerbeheer.

Voorwaarden

Deze connector is alleen bedoeld voor gebruik met een Databricks SQL Warehouse dat wordt uitgevoerd op AWS en OAuth gebruikt. Als u Azure Databricks gebruikt, gebruikt u de Azure Databricks-connector. Als u geen OAuth gebruikt met uw Databricks SQL Warehouse (op AWS of GCP), gebruikt u ook de connector Azure Databricks. Databricks Community Edition wordt niet ondersteund.

Ondersteunde mogelijkheden

• Importeren
• DirectQuery (Power BI semantische modellen)

Parameters

Toegangspunt:DatabricksMultiCloud.Catalogs

Vereist aantal parameters: 2

Parameter	weergavenaam	Required	Type	Group	Beschrijving	Voorbeeldwaarden	Nullbaar
host	Serverhostnaam	Yes	tekst		De hostnaam van de Databricks-server.	"example.azuredatabricks.net"	false
httpPath	HTTP-pad	Yes	tekst		Het HTTP-pad van het cluster.	"/sql/1.0/warehouses/abcdef1234567890"	false
options	Geavanceerde opties	No	record met de mogelijkheid tot null-waarde	Geavanceerde opties			true

Velden in options

Veld	weergavenaam	Required	Type	Group	Beschrijving	Als standaard gedeclareerd	Toegestane waarden	Voorbeeldwaarden	Nullbaar	Optional	Metagegevens van toegestane waarden	Gedeclareerde toegestane waarden
options.Catalog	Standaardcatalogus	No	tekst	Geavanceerde opties	Selecteer een standaardcatalogus voor de verbinding.				false	true
options.Database	Database	No	tekst	Geavanceerde opties	Beperk de verbinding tot de geselecteerde database. Hierdoor kunnen tabellen sneller worden opgelijst, maar hiermee voorkomt u query folding voor query's die meerdere verschillende databases raken.				false	true
options.QueryTags	Zoektags	No	tekst	Geavanceerde opties	Sleutelwaardetags voor het bijhouden van query's in de tabel system.query.history.			"tag1:value1,tag2:value2"	false	true
options.EnableAutomaticProxyDiscovery	Automatische proxydetectie	No	tekst	Geavanceerde opties	Dit maakt automatische systeemwijde proxydetectie in Windows mogelijk.		"ingeschakeld" (Ingeschakeld); "uitgeschakeld" (Uitgeschakeld (standaard))		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	tekst	Geavanceerde opties	Gebruik '2.0 (beta)' om ADBC op te geven. De waarde 'default' gebruikt de omgevingsconfiguratie om te bepalen welk stuurprogramma moet worden gebruikt.	"2.0"	"2.0" (2.0 - ADBC); null (systeemstandaard)		false	true		["2.0", null]
options.Protocol	Protocol	No	tekst	Geavanceerde opties	Hiermee wordt het protocol opgegeven dat door het ADBC-stuurprogramma wordt gebruikt. Selecteer 'REST (SEA)' om de Statement Execution API te gebruiken. Als deze niet is ingesteld, wordt de standaardwaarde van de driver (Thrift) gebruikt.	nul	null (standaard); "rest" (REST (SEA))		false	true		[null, "rest"]

Verbinding maken vanuit Power Query Desktop

Voer de volgende stappen uit om vanaf Power Query Desktop verbinding te maken met Databricks:

1. In de Gegevens ophalen-ervaring, zoek naar Databricks- om de Databricks-connector in de lijst te zetten. Gebruik hier alleen de Databricks-connector voor uw Databricks SQL Warehouse-gegevens (uitgevoerd op AWS) als u OAuth gebruikt voor verificatie.

   

2. Geef de serverhostnaam en HTTP-pad voor uw Databricks SQL Warehouse. Raadpleeg de configuratie van de Databricks ODBC- en JDBC-stuurprogramma's voor instructies om uw 'serverhostnaam' en 'HTTP-pad' op te zoeken. Voer deze gegevens dienovereenkomstig in. U kunt desgewenst een standaardcatalogus en/of database opgeven onder Geavanceerde opties. Selecteer OK- om door te gaan.

   

3. Geef uw referenties op om te verifiëren met uw Databricks SQL Warehouse. U hebt drie opties voor referenties:

   • Databricks-clientcredentials. Raadpleeg Databricks OAuth M2M voor instructies voor het genereren van Databricks OAuth M2M-clientreferenties.

   • Persoonlijk toegangstoken. Raadpleeg persoonlijke toegangstokens voor instructies voor het genereren van een persoonlijk toegangstoken (PAT).

   • OAuth (OIDC). Meld u aan bij uw organisatieaccount via de pop-up van de browser.

     

   Notitie

   Nadat u uw referenties voor een bepaald Databricks SQL Warehouse hebt ingevoerd, slaat Power BI Desktop deze referenties op en hergebruikt ze bij volgende verbindingspogingen. U kunt deze inloggegevens wijzigen door naar Bestand > Opties en instellingen van > Instellingen voor gegevensbronte gaan. Meer informatie: De verificatiemethode wijzigen

4. Zodra u verbinding hebt gemaakt, worden in de Navigator- de gegevens weergegeven die voor u beschikbaar zijn op het cluster. U kunt kiezen Transform Data om de gegevens te transformeren met behulp van Power Query of Load om de gegevens in Power Query Desktop te laden.

   

Verbinding maken vanuit Power Query Online

Voer de volgende stappen uit om vanuit Power Query Online verbinding te maken met Databricks:

1. Selecteer de optie Databricks bij gegevens ophalen. Verschillende apps hebben verschillende manieren om toegang te krijgen tot de gegevensopvraagervaring van Power Query Online. Ga naar Waar u gegevens kunt ophalen voor meer informatie over hoe u vanuit uw app toegang krijgt tot de Power Query Online gegevenservaring.

   Maak een korte lijst met de beschikbare Databricks-connector met het zoekvak. Selecteer de Databricks-connector voor uw Databricks SQL Warehouse.

   

2. Voer de Server-hostnaam in en HTTP-pad voor uw Databricks SQL Warehouse. Raadpleeg de configuratie van de Databricks ODBC- en JDBC-stuurprogramma's voor instructies om uw 'serverhostnaam' en 'HTTP-pad' op te zoeken. U kunt desgewenst een standaardcatalogus en/of database opgeven onder Geavanceerde opties.

   

3. Geef uw referenties op om te verifiëren met uw Databricks SQL Warehouse. Er zijn drie opties voor referenties:

   • Basisch. Gebruik deze optie bij het verifiëren met een gebruikersnaam en wachtwoord. Deze optie is niet beschikbaar als uw organisatie/account 2FA/MFA gebruikt.
   • Accountsleutel. Gebruik deze optie bij het verifiëren met een persoonlijk toegangstoken. Raadpleeg persoonlijke toegangstokens voor instructies voor het genereren van een persoonlijk toegangstoken (PAT).
   • Organisatieaccount. Gebruik deze optie bij het verifiëren met OAuth. Meld u aan bij uw organisatieaccount via de pop-up van de browser.

4. Zodra u verbinding hebt gemaakt, verschijnt de Navigator- en worden de gegevens die beschikbaar zijn op de server, getoond. Selecteer uw gegevens in de navigator. Selecteer vervolgens Next om de gegevens in Power Query te transformeren.

   

Aanvullende informatie

Implementatie van een connector voor een Arrow Database Connectivity-driver

U kunt het stuurprogramma Arrow Database Connectivity (ADBC) gebruiken voor de Databricks-connector in Power BI. Naarmate we doorgaan met het verbeteren en toevoegen van nieuwe mogelijkheden aan deze connector, raden we u aan om een upgrade uit te voeren naar de nieuwste versie om het uit te proberen en productfeedback te verzenden.

Ga als volgende te werk om over te schakelen naar het ADBC-stuurprogramma:

1. Open het gewenste dashboard in Power BI.

2. Selecteer Gegevens transformeren.

3. Selecteer Geavanceerde editor in de optiesectie Query.

4. Geef Implementation="2.0" op voor 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