Azure Databricks

Uwaga / Notatka

Ten łącznik jest własnością i udostępniany przez usługę Databricks.

Podsumowanie

Property Value
Connector Ikona Azure Databricks Azure Databricks
Produkty Power BI (modele semantyczne)
Power Query Online
Stan wydania Ogólna dostępność
Category Database
Rodzaje uwierzytelniania Azure Active Directory
Poświadczenia klienta usługi Databricks
Osobisty token dostępu
Uwierzytelnianie specyficzne dla produktu Service Principal (Power BI / Fabric)
Tożsamość przestrzeni roboczej (Power BI / Fabric)
Rodzaj źródła danych Databricks
Dokumentacja referencyjna funkcji Databricks.Catalogs
Databricks.Contents
Databricks.Query

Ważna

Łącznik Azure Databricks dla Power BI obsługuje teraz sterownik Arrow Database Connectivity (ADBC). Ten łącznik jest przenoszony z wbudowanego sterownika Simba Spark ODBC na sterownik Databricks ADBC. Aby uzyskać wskazówki dotyczące migracji, kluczowe daty i mechanizmy kontroli administratora, zobacz artykuł Przejście ze sterowników ODBC na sterowniki ADBC w usłudze Power BI i rozwiązaniu Fabric.

Wymagania wstępne

W przypadku sieci prywatnych należy zaimplementować następujące ustawienia sieciowe:

  • *.blob.core.windows.net* i *.store.core.windows.net muszą być otwarte w środowisku sieciowym.
  • Ta lista pobrań i odwołań certyfikatów musi być również dodana do listy dozwolonych.
  • Jeśli funkcja zapory jest włączona na koncie magazynowania obszaru roboczego Databricks, musisz skonfigurować bramę danych sieci wirtualnej lub bramę danych lokalną, aby zezwolić na prywatny dostęp do konta magazynowania. Dzięki temu usługa Fabric Power BI może nadal uzyskiwać dostęp do konta magazynu obszaru roboczego, a usługa CloudFetch nadal działa prawidłowo. Alternatywnie możesz wyłączyć funkcję CloudFetch z konfiguracją EnableQueryResultDownload=0.

Obsługiwane funkcje

  • Importowanie
  • DirectQuery (modele semantyczne Power BI)

Parameters

Punkt wejścia:Databricks.Catalogs

Wymagana liczba parametrów: 2

Parametr Wyświetlana nazwa Required Typ Group Opis Przykładowe wartości Zanullowalny
gospodarz Nazwa hosta serwera Tak SMS Nazwa hosta serwera usługi Databricks. "example.azuredatabricks.net" false
httpPath HTTP Path (Ścieżka HTTP) Tak SMS Ścieżka HTTP klastra. "/sql/1.0/warehouses/abcdef1234567890" false
options Opcje zaawansowane Nie rekord dopuszczany do wartości null Opcje zaawansowane true

Pola w options

Pole Wyświetlana nazwa Required Typ Group Opis Zadeklarowane domyślne Dozwolone wartości Przykładowe wartości Zanullowalny Optional Metadane dozwolonych wartości Zadeklarowane dozwolone wartości
options.Catalog Katalog domyślny Nie SMS Opcje zaawansowane Wybierz domyślny katalog dla połączenia. false true
options.Database Database Nie SMS Opcje zaawansowane Ogranicz połączenie z wybraną bazą danych. Może to przyspieszyć wyświetlanie listy tabel, jednak uniemożliwi query folding w przypadku zapytań, które trafią do wielu różnych baz danych. false true
options.QueryTags Tagi zapytań Nie SMS Opcje zaawansowane Tagi klucz-wartość do śledzenia zapytań w tabeli system.query.history. "tag1:value1,tag2:value2" false true
options.EnableAutomaticProxyDiscovery Automatyczne odnajdywanie serwera proxy Nie SMS Opcje zaawansowane Umożliwia to automatyczne wykrywanie serwera proxy w całym systemie Windows. "włączone" (włączone); "wyłączone" (Wyłączone (ustawienie domyślne)) false true [{"Metadata": {"Documentation.Caption": "Włączone", "Documentation.Name": "AutomaticProxyDiscoveryFlag.Enabled"}, "Value": "enabled"}, {"Metadata": {"Documentation.Caption": "Wyłączone (ustawienie domyślne),", "Documentation.Name": "AutomaticProxyDiscoveryFlag.Disabled"}, "Value": "disabled"}] ["włączone", "wyłączone"]
opcje.Implementacja Implementation Nie SMS Opcje zaawansowane Użyj ciągu "2.0 (beta)", aby określić usługę ADBC. Wartość "domyślna" użyje konfiguracji środowiska, aby określić, który sterownik ma być używany. "2.0" "2.0" (2.0 - ADBC); null (wartość domyślna systemu) false true ["2.0", null]
options.Protocol Protocol Nie SMS Opcje zaawansowane Określa protokół używany przez sterownik ADBC. Wybierz pozycję "REST (SEA)", aby użyć interfejsu API wykonywania instrukcji. Jeśli nie zostanie ustawiona, zostanie użyta wartość domyślna sterownika (Thrift). null null (wartość domyślna); "rest" (REST (SEA)) false true [null, "rest"]

Nawiązywanie połączenia z poziomu programu Power Query Desktop

AWS, Azure lub GCP

Aby nawiązać połączenie z usługą Databricks z poziomu programu Power Query Desktop, wykonaj następujące kroki:

  1. W środowisku Pobierania danych wyszukaj Databricks, aby wyświetlić łącznik Azure Databricks. Użyj łącznika Azure Databricks dla wszystkich danych Databricks SQL Warehouse, chyba że uzyskałeś/uzyskałaś inne instrukcje od przedstawiciela Databricks.

    Zrzut ekranu przedstawiający okno dialogowe Pobieranie danych dla usługi Databricks Cloud.

  2. Podaj nazwę hosta serwera i ścieżkę HTTP dla usługi Databricks SQL Warehouse. Zapoznaj się z Konfigurowaniem sterowników ODBC i JDBC usługi Databricks, aby uzyskać instrukcje dotyczące odnajdywania swojej "nazwy hosta serwera" i "ścieżki HTTP". Wprowadź te informacje odpowiednio. Opcjonalnie możesz podać domyślny katalog i/lub bazę danych w obszarze Opcje zaawansowane. Naciśnij OK, aby kontynuować.

    Zrzut ekranu przedstawiający pola połączenia Databricks SQL Warehouse.

  3. Podaj swoje poświadczenia, aby się uwierzytelnić w usłudze Databricks SQL Warehouse. Istnieją trzy opcje poświadczeń:

    • Poświadczenia klienta usługi Databricks. Zapoznaj się z Databricks OAuth M2M, aby otrzymać instrukcje dotyczące generowania poświadczeń klienta OAuth M2M dla usługi Databricks.

    • Osobisty token dostępu (do użycia w przypadku platform AWS, Azure lub GCP). Aby uzyskać instrukcje dotyczące generowania osobistego tokenu dostępu (PAT), zobacz Osobiste tokeny dostępu.

    • Azure Active Directory (można używać tylko dla Azure). Zaloguj się do konta organizacyjnego przy użyciu wyskakującego okienka przeglądarki.

      Zrzut ekranu przedstawiający pole wprowadzania tokenu usługi Databricks.

    Uwaga / Notatka

    Po wprowadzeniu poświadczeń dla określonego magazynu Databricks SQL Warehouse, Power BI Desktop zapamiętuje i ponownie używa tych samych poświadczeń w kolejnych próbach połączenia. Te poświadczenia można zmodyfikować, przechodząc do Plik > Opcje i ustawienia > Ustawienia źródła danych. Więcej informacji: Zmienianie metody uwierzytelniania

  4. Po pomyślnym nawiązaniu połączenia nawigator wyświetla dane dostępne w klastrze. Możesz wybrać Transform Data aby przekształcić dane przy użyciu Power Query lub Load aby załadować dane w programie Power Query Desktop.

    Obraz nawigatora Power Query ładowanie danych z usługi Databricks Cloud do aplikacji desktopowej.

Nawiązywanie połączenia z usługi Power Query Online

Aby nawiązać połączenie z usługą Databricks z usługi Power Query Online, wykonaj następujące kroki:

  1. Wybierz opcję Azure Databricks w środowisku pobierania danych. Różne aplikacje mają różne sposoby uzyskiwania dostępu do funkcji pobierania danych w usłudze Power Query Online. Aby uzyskać więcej informacji na temat korzystania z doświadczenia pozyskiwania danych w Power Query Online z Twojej aplikacji, przejdź do Gdzie uzyskać dane.

    Wyszukaj dostępne łączniki usługi Databricks za pomocą pola wyszukiwania. Użyj łącznika Azure Databricks dla wszystkich danych Databricks SQL Warehouse, chyba że uzyskałeś/uzyskałaś inne instrukcje od przedstawiciela Databricks.

    Zrzut ekranu opcji łącznika Databricks w Power Query.

  2. Wprowadź nazwę hosta serwera jako oraz jako ścieżkę HTTP dla Databricks SQL Warehouse. Zapoznaj się z Konfigurowaniem sterowników ODBC i JDBC usługi Databricks, aby uzyskać instrukcje dotyczące odnajdywania swojej "nazwy hosta serwera" i "ścieżki HTTP". Opcjonalnie możesz podać domyślny katalog i/lub bazę danych w obszarze Opcje zaawansowane.

     Zrzut ekranu przedstawiający ustawienia i poświadczenia połączenia dla Azure Databricks.

  3. Podaj swoje poświadczenia, aby się uwierzytelnić w usłudze Databricks SQL Warehouse. Istnieją cztery opcje poświadczeń:

    • Poświadczenia klienta usługi Databricks. Aby uzyskać instrukcje dotyczące generowania poświadczeń klienta OAuth M2M usługi Databricks, zobacz Databricks OAuth M2M.
    • Osobisty token dostępu (do użycia w przypadku platform AWS, Azure lub GCP). Zapoznaj się z Osobiste tokeny dostępu, aby uzyskać instrukcje dotyczące generowania Osobistego Tokenu Dostępu (PAT).
    • Azure Active Directory (można używać tylko dla Azure). Zaloguj się do konta organizacyjnego przy użyciu wyskakującego okienka przeglądarki.
    • Jednostka usługi (dostępna tylko dla Azure). Uwierzytelnij się za pomocą nazwy głównej usługi Microsoft Entra ID. Ta opcja jest dostępna podczas konfigurowania połączenia w chmurze lub bramy.
  4. Po pomyślnym nawiązaniu połączenia zostanie wyświetlony nawigator , który wyświetli dane dostępne na serwerze. Wybierz swoje dane w nawigatorze. Następnie wybierz pozycję Dalej aby przekształcić dane w Power Query.

    Zrzut ekranu przedstawiający nawigator Power Query ładujący dane z usługi Databricks Cloud do aplikacji online.

Dodatkowe informacje

Implementacja łącznika sterownika Arrow Database Connectivity

Możesz użyć sterownika Arrow Database Connectivity (ADBC) dla łącznika Azure Databricks w Power BI. W miarę rozszerzania i dodawania nowych funkcji do tego łącznika zalecamy uaktualnienie do najnowszej wersji, aby wypróbować go i przesłać opinię o produkcie.

Uwaga / Notatka

Od lutego 2026 r. nowe połączenia utworzone w programie Power BI Desktop lub usłudze Power BI automatycznie będą domyślnie używać sterownika Arrow Database Connectivity (ADBC). Istniejące połączenia będą nadal używać ODBC, chyba że ręcznie zaktualizujesz je do usługi ADBC.

Aby przełączyć się do sterownika ADBC:

  1. Otwórz żądany pulpit nawigacyjny w Power BI.
  2. Wybierz Przekształć dane.
  3. Wybierz Edytor zaawansowany w sekcji opcji Query.
  4. Określ Implementation="2.0" dla usługi 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
    

Ograniczenia i zagadnienia

  • Łącznik Azure Databricks obsługuje serwer proxy web. Jednak ustawienia automatycznego serwera proxy zdefiniowane w plikach .pac nie są obsługiwane.
  • Łącznik Azure Databricks nie obsługuje źródła danych Databricks.Query w połączeniu z trybem DirectQuery modelu semantycznego Power BI.