Azure Databricks

Opmerking

Deze connector is eigendom van en wordt geleverd door Databricks.

Samenvatting

Property Value
Connector Azure Databricks pictogram Azure Databricks
Producten Power BI (semantische modellen)
Power Query Online
Releasefase Algemene beschikbaarheid
Categorie Database
Verificatietypen Azure Active Directory
Databricks-klantreferenties
Persoonlijk toegangstoken
Productspecifieke authenticatie Service Principal (Power BI / Fabric)
Werkruimte-identiteit (Power BI / Fabric)
Soort gegevensbron Databricks
Documentatie voor functiereferenties Databricks.Catalogs
Databricks.Contents
Databricks.Query

Important

De Azure 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.

Prerequisites

Voor privénetwerken moet u de volgende netwerkinstellingen implementeren:

  • *.blob.core.windows.net* en *.store.core.windows.net moeten zijn geopend in uw netwerkomgeving.
  • Deze lijst met certificaatdownloads en intrekkingen moet ook worden toegevoegd aan uw acceptatielijst.
  • Als firewallondersteuning is ingeschakeld voor uw Databricks-werkruimteopslagaccount, moet u een gegevensgateway voor een virtueel netwerk of een on-premises gegevensgateway configureren om privétoegang tot het opslagaccount toe te staan. Dit zorgt ervoor dat de Fabric-Power BI-service toegang kan blijven krijgen tot het opslagaccount van de werkruimte en dat CloudFetch correct blijft functioneren. U kunt CloudFetch ook uitschakelen met de configuratie EnableQueryResultDownload=0.

Ondersteunde mogelijkheden

  • Importeren
  • DirectQuery (Power BI semantische modellen)

Parameters

Toegangspunt:Databricks.Catalogs

Aantal verplichte 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
opties.database Database No tekst Geavanceerde opties Beperk de verbinding tot de geselecteerde database. Hierdoor kunnen tabellen sneller worden vermeld, 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 systeembrede Windows-proxydetectie 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 'standaard' gebruikt de omgevingsconfiguratie om te bepalen welke driver moet worden gebruikt. "2.0" "2.0" (2.0 - ADBC); null (systeemstandaard) false true ["2.0", null]
options.Protocol Protocol No tekst Geavanceerde opties Specificeert het protocol dat wordt gebruikt door het ADBC-stuurprogramma. Selecteer 'REST (SEA)' om de Statement Execution API te gebruiken. Als deze niet is ingesteld, wordt de standaardwaarde van het stuurprogramma (Thrift) gebruikt. nul null (standaard); "rest" (REST (SEA)) false true [null, "rest"]

Verbinding maken vanuit Power Query Desktop

AWS, Azure of GCP

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 Azure Databricks te selecteren. Gebruik de Azure Databricks-connector voor alle Databricks SQL Warehouse-gegevens, tenzij u anders bent geïnstrueerd door uw Databricks-vertegenwoordiger.

    Schermopname van het dialoogvenster Gegevens ophalen voor Databricks Cloud.

  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.

    Schermopname van de databricks SQL Warehouse-verbindingsvelden.

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

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

    • Persoonlijk toegangstoken (bruikbaar voor AWS, Azure of GCP). Zie Persoonlijke toegangstokens voor instructies voor het genereren van een persoonlijk toegangstoken (PAT).

    • Azure Active Directory (alleen bruikbaar voor Azure). Meld u aan bij uw organisatieaccount via de pop-up van de browser.

      Schermopname van het invoerveld van het Databricks-token.

    Opmerking

    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.

    Afbeelding van Power Query-navigator die Databricks Cloud-gegevens laadt naar desktopapplicatie.

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 Azure Databricks in de gegevens ophalen ervaring. 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.

    Gebruik het zoekvak om een korte lijst te maken van de beschikbare Databricks-connectors. Gebruik de Azure Databricks-connector voor alle Databricks SQL Warehouse-gegevens, tenzij u anders bent geïnstrueerd door uw Databricks-vertegenwoordiger.

    Schermopname van de Databricks-connectoropties in Power Query.

  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.

    Schermopname van de verbindingsinstellingen en -referenties voor Azure Databricks.

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

    • Databricks-clientverificatiegegevens. Voor instructies voor het genereren van Databricks OAuth M2M-clientreferenties, zie Databricks OAuth M2M.
    • Persoonlijk toegangstoken (bruikbaar voor AWS, Azure of GCP). Raadpleeg persoonlijke toegangstokens voor instructies voor het genereren van een persoonlijk toegangstoken (PAT).
    • Azure Active Directory (alleen bruikbaar voor Azure). Meld u aan bij uw organisatieaccount via de pop-up van de browser.
    • Service-principal (alleen bruikbaar voor Azure). Verifiëren met een Microsoft Entra ID service-principal. Deze optie is beschikbaar bij het configureren van een cloud- of gatewayverbinding.
  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.

    Schermopname van de Power Query navigator die Databricks Cloud-gegevens laadt naar online app.

Aanvullende informatie

Implementatie van een connector voor een Arrow Database Connectivity-driver

U kunt het stuurprogramma Arrow Database Connectivity (ADBC) gebruiken voor de Azure 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.

Opmerking

Sinds februari 2026 zullen nieuwe verbindingen die zijn gemaakt in Power BI Desktop of Power BI Service automatisch het Arrow Database Connectivity (ADBC) stuurprogramma gebruiken. Bestaande verbindingen blijven ODBC gebruiken, tenzij u ze handmatig bijwerkt naar ADBC.

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

Beperkingen en overwegingen

  • De Azure Databricks-connector ondersteunt webproxy. Automatische proxy-instellingen die zijn gedefinieerd in PAC-bestanden worden echter niet ondersteund.
  • In de Azure Databricks-connector wordt de Databricks.Query-gegevensbron niet ondersteund in combinatie met de DirectQuery-modus van Power BI semantisch model.