Azure Databricks

Anmärkning

Den här anslutningsappen ägs och tillhandahålls av Databricks.

Sammanfattning

Property Value
Connector Azure Databricks-ikonen Azure Databricks
Produkter Power BI (semantiska modeller)
Power Query Online
Versionsstatus Allmän tillgänglighet
Category Database
Autentiseringstyper Azure Active Directory
Autentiseringsuppgifter för Databricks-klienten
Personlig åtkomsttoken
Produktspecifik autentisering Tjänsthuvudnamn (Power BI / Fabric)
Identitet för arbetsyta (Power BI/Fabric)
Typ av datakälla Databricks
Dokumentation om funktionsreferens Databricks.Catalogs
Databricks.Contents
Databricks.Query

Viktigt!

Azure Databricks-anslutningsappen för Power BI stöder nu drivrutinen Arrow Database Connectivity (ADBC). Det här anslutningsprogrammet övergår från den inbäddade Simba Spark ODBC-drivrutinen till Databricks ADBC-drivrutinen. Information om migreringsvägledning, nyckeldatum och administratörskontroller finns i Transition från ODBC till ADBC-drivrutiner i Power BI och Fabric.

Prerequisites

För privata nätverk måste du implementera följande nätverksinställningar:

  • *.blob.core.windows.net* och *.store.core.windows.net måste vara öppna i nätverksmiljön.
  • Den här listan över nedladdningar och återkallanden av certifikat måste också läggas till i listan över tillåtna certifikat.
  • Om brandväggsstöd är aktiverat på ditt Databricks-arbetsytelagringskonto måste du konfigurera antingen en virtuell nätverksdatagateway eller en lokal datagateway för att tillåta privat åtkomst till lagringskontot. Detta säkerställer att Fabric-služba Power BI kan fortsätta att komma åt arbetsytans lagringskonto och att CloudFetch fortsätter att fungera korrekt. Du kan också inaktivera CloudFetch med konfigurationen EnableQueryResultDownload=0.

Funktioner som stöds

  • Importera
  • DirectQuery (Power BI semantiska modeller)

Parameters

Startpunkt:Databricks.Catalogs

Antal obligatoriska parametrar: 2

Parameter Visningsnamn Required Type Group Beskrivning Exempelvärden Nullbar
host Servervärdnamn Yes text Databricks-serverns värdnamn. "example.azuredatabricks.net" false
httpPath HTTP-sökväg Yes text HTTP-sökvägen för klustret. "/sql/1.0/warehouses/abcdef1234567890" false
options Avancerade alternativ No nullbar posttyp Avancerade alternativ true

Fält i options

Fält Visningsnamn Required Type Group Beskrivning Deklarerat standardvärde Tillåtna värden Exempelvärden Nullbar Optional Metadata för tillåtna värden Deklarerade tillåtna värden
options.Catalog Standardkatalog No text Avancerade alternativ Välj en standardkatalog för anslutningen. false true
alternativ.Databas Database No text Avancerade alternativ Begränsa anslutningen till den valda databasen. Detta kan göra listningstabeller snabbare, men det förhindrar query folding för frågor som träffar flera olika databaser. false true
options.QueryTags Frågetaggar No text Avancerade alternativ Nyckelvärdestaggar för att spåra frågor i tabellen system.query.history. "tag1:value1,tag2:value2" false true
options.EnableAutomaticProxyDiscovery Automatisk identifiering av proxy No text Avancerade alternativ Detta möjliggör automatisk systemomfattande proxyidentifiering i Windows. "Aktiverad" (Aktiverad); "Inaktiverad" (Inaktiverad (standardvärde)) false true [{"Metadata": {"Documentation.Caption": "Enabled", "Documentation.Name": "AutomaticProxyDiscoveryFlag.Enabled"}, "Value": "enabled"}, {"Metadata": {"Documentation.Caption": "Disabled (default)", "Documentation.Name": "AutomaticProxyDiscoveryFlag.Disabled"}, "Value": "disabled"}] ["aktiverad", "inaktiverad"]
options.Implementation Implementation No text Avancerade alternativ Använd "2.0 (beta)" för att ange ADBC. Standardvärdet använder miljökonfigurationen för att avgöra vilken drivrutin som ska användas. "2.0" "2.0" (2.0 - ADBC); null (Systemstandard) false true ["2.0", null]
options.Protocol Protocol No text Avancerade alternativ Anger det protokoll som används av ADBC-drivrutinen. Välj REST (SEA) för att använda Statement Execution API. När den inte har angetts används drivrutinsstandarden (Thrift). noll null (standard); "rest" (REST (SEA)) false true [null, "rest"]

Ansluta från Power Query Desktop

AWS, Azure eller GCP

Utför följande steg för att ansluta till Databricks från Power Query Desktop:

  1. I upplevelsen 'Hämta data' söker du efter Databricks för att välja Databricks-anslutningen, Azure Databricks. Använd anslutningsappen Azure Databricks för alla Databricks SQL Warehouse-data om du inte har fått instruktioner om något annat av databricksrepresentanten.

    Skärmbild av dialogrutan Hämta data för Databricks Cloud.

  2. Ange serverns värdnamn och HTTP-sökväg för ditt Databricks SQL Warehouse. Se Konfigurera Databricks ODBC- och JDBC-drivrutinerna för instruktioner om hur du hittar ditt "Servernamn" och "HTTP-sökväg". Ange den här informationen i enlighet med detta. Du kan också ange en standardkatalog och/eller databas under Avancerade alternativ. Välj OK för att gå vidare.

    Skärmbild av anslutningsfälten för Databricks SQL Warehouse.

  3. Ange dina autentiseringsuppgifter för att autentisera med ditt Databricks SQL Warehouse. Det finns tre alternativ för autentiseringsuppgifter:

    • Autentiseringsuppgifter för Databricks-klienten. Mer information om hur du genererar autentiseringsuppgifter för Databricks OAuth M2M finns i Databricks OAuth M2M-klientautentiseringsuppgifter.

    • Personal Access Token (användbar för AWS, Azure eller GCP). Anvisningar om hur du genererar en personlig åtkomsttoken (PAT) finns i Personliga åtkomsttoken.

    • Azure Active Directory (endast användbar för Azure). Logga in på ditt organisationskonto med hjälp av webbläsar-popup-fönstret.

      Skärmbild av inmatningsfältet för Databricks-token.

    Anmärkning

    När du har angett dina autentiseringsuppgifter för ett visst Databricks SQL Warehouse cachelagrar Power BI Desktop och återanvänder samma autentiseringsuppgifter i efterföljande anslutningsförsök. Du kan ändra dessa autentiseringsuppgifter genom att gå till Filalternativ > och inställningar > Inställningar för datakälla. Mer information: Ändra autentiseringsmetoden

  4. När du har anslutit visar Navigator de data som är tillgängliga för dig i klustret. Du kan välja antingen Transform Data för att transformera data med Power Query eller Load för att läsa in data i Power Query Desktop.

    Bild av Power Query-navigator som laddar Databricks Cloud-data till skrivbordsapp.

Ansluta från Power Query Online

Utför följande steg för att ansluta till Databricks från Power Query Online:

  1. Välj alternativet Azure Databricks i 'hämta data'-upplevelsen. Olika appar har olika sätt att komma till Power Query Online för att hämta data. Mer information om hur du kommer till Power Query Online från din app för att få en datainhämtning finns i Var du hämtar data.

    Lista de tillgängliga Databricks-anslutningarna med hjälp av sökrutan. Använd anslutningsappen Azure Databricks för alla Databricks SQL Warehouse-data om du inte har fått instruktioner om något annat av databricksrepresentanten.

    Screenshot för Databricks-anslutningsalternativen i Power Query.

  2. Ange servervärdnamn och HTTP-sökväg för ditt Databricks SQL Warehouse. Se Konfigurera Databricks ODBC- och JDBC-drivrutinerna för instruktioner om hur du hittar ditt "Servernamn" och "HTTP-sökväg". Du kan också ange en standardkatalog och/eller databas under Avancerade alternativ.

    Skärmbild av anslutningsinställningar och autentiseringsuppgifter för Azure Databricks.

  3. Ange dina autentiseringsuppgifter för att autentisera med ditt Databricks SQL Warehouse. Det finns fyra alternativ för behörighet:

    • Autentiseringsuppgifter för Databricks-klienten. För instruktioner om hur du genererar Databricks OAuth M2M Client Credentials, se Databricks OAuth M2M.
    • Personal Access Token (användbar för AWS, Azure eller GCP). Se Personliga åtkomsttoken för instruktioner om hur du genererar en personlig åtkomsttoken (PAT).
    • Azure Active Directory (endast användbar för Azure). Logga in på ditt organisationskonto med hjälp av webbläsar-popup-fönstret.
    • Service Principal (endast användbar för Azure). Autentisera med en Microsoft Entra ID-tjänstehuvudansvarig. Detta alternativ finns tillgängligt vid konfiguration av en moln- eller gatewayanslutning.
  4. När du har anslutit visas Navigator och visar tillgängliga data på servern. Välj dina data i navigatören. Välj sedan Nästa för att transformera data i Power Query.

    Skärmbild av Power Query navigator som läser in Databricks Cloud-data till onlineappen.

Ytterligare information

Implementering av Arrow Database Connectivity-drivrutinsanslutning

Du kan använda drivrutinen Arrow Database Connectivity (ADBC) för Azure Databricks-anslutningsappen i Power BI. När vi fortsätter att förbättra och lägga till nya funktioner i den här kontakten rekommenderar vi att du uppgraderar till den senaste versionen för att testa den och skicka produktfeedback.

Anmärkning

Sedan februari 2026 använder nya anslutningar som skapas i Power BI Desktop eller Power BI-tjänsten automatiskt drivrutinen för Arrow Database Connectivity (ADBC) som standard. Befintliga anslutningar fortsätter att använda ODBC om du inte uppdaterar dem till ADBC manuellt.

Så här växlar du till ADBC-drivrutinen:

  1. Öppna önskad instrumentpanel i Power BI.
  2. Välj Transformera data.
  3. Välj Rozšírený editor i alternativavsnittet Query.
  4. Ange Implementation="2.0" för 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
    

Begränsningar och överväganden

  • Azure Databricks-anslutningsappen stöder web proxy. Automatiska proxyinställningar som definierats i .pac-filer stöds dock inte.
  • I Azure Databricks-anslutningsappen stöds inte Databricks.Query-datakällan i kombination med Power BI semantikmodellens DirectQuery-läge.