Databricks

Notatka

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

Streszczenie

Property	Value
Connector	Databricks
Produkty	Power BI (modele semantyczne) Power Query Online
Stan wydania	Ogólna dostępność
Category	Database
Rodzaje uwierzytelniania	Poświadczenia klienta usługi Databricks OAuth (OIDC) Osobisty token dostępu
Rodzaj źródła danych	DatabricksMultiCloud
Dokumentacja referencyjna funkcji	DatabricksMultiCloud.Catalogs DatabricksMultiCloud.Query

Notatka

Niektóre funkcje mogą być obecne w jednym produkcie, ale nie w innych ze względu na harmonogramy wdrażania i możliwości specyficzne dla hosta.

Ważna

Łącznik usługi 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.

Warunki wstępne

Ten łącznik służy tylko do użytku z usługą Databricks SQL Warehouse działającą na platformie AWS i przy użyciu protokołu OAuth. Jeśli używasz Azure Databricks, użyj łącznika Azure Databricks. Jeśli nie używasz protokołu OAuth w usłudze Databricks SQL Warehouse (na platformie AWS lub GCP), użyj łącznika Azure Databricks. Wersja Community Edition usługi Databricks nie jest obsługiwana.

Obsługiwane funkcje

• Importowanie
• DirectQuery (modele semantyczne Power BI)

Parameters

Punkt wejścia:DatabricksMultiCloud.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 jako 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ć listowanie tabel, jednak uniemożliwi zwijanie zapytań 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": "włączone"}, {"Metadata": {"Documentation.Caption": "Wyłączone (domyślne)", "Documentation.Name": "AutomaticProxyDiscoveryFlag.Disabled"}, "Value": "wyłączone"}]	["enabled", "disabled"]
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

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

1. W środowisku "Pobieranie danych" wyszukaj Databricks, aby skrótowo wyświetlić łącznik Databricks. Należy używać łącznika Databricks wyłącznie do danych Magazynu SQL Databricks, które są uruchomione na platformie AWS, jeśli do uwierzytelniania używasz protokołu OAuth.

   

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. Wybierz pozycję OK, aby kontynuować.

   

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

   • Poświadczenia klienta usługi Databricks. Zapoznaj się z instrukcjami dotyczącymi generowania poświadczeń klienta Databricks OAuth M2M.

   • Osobisty token dostępu. Zapoznaj się z Osobiste tokeny dostępu, aby uzyskać instrukcje dotyczące generowania Osobistego Tokenu Dostępu (PAT).

   • OAuth (OIDC). Zaloguj się do konta organizacyjnego przy użyciu wyskakującego okienka przeglądarki.

     

   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 pozycji Plik > Opcje i ustawienia > Ustawienia źródła danych. Więcej informacji: Zmień metodę 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.

   

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ę Databricks w sekcji 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.

   Krótki opis dostępnego łącznika usługi Databricks z polem wyszukiwania. Wybierz łącznik Databricks dla usługi Databricks SQL Warehouse.

   

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.

   

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

   • Podstawowy. Użyj tej opcji podczas uwierzytelniania przy użyciu nazwy użytkownika i hasła. Ta opcja nie jest dostępna, jeśli organizacja/konto używa uwierzytelniania 2FA/uwierzytelniania wieloskładnikowego.
   • Klucz konta. Użyj tej opcji podczas uwierzytelniania przy użyciu osobistego tokenu dostępu. Zapoznaj się z Osobiste tokeny dostępu, aby uzyskać instrukcje dotyczące generowania Osobistego Tokenu Dostępu (PAT).
   • Konto organizacyjne. Użyj tej opcji podczas uwierzytelniania przy użyciu protokołu OAuth. Zaloguj się do konta organizacyjnego przy użyciu wyskakującego okienka przeglądarki.

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.

   

Dodatkowe informacje

Implementacja łącznika sterownika Arrow Database Connectivity

Możesz użyć sterownika Arrow Database Connectivity (ADBC) dla łączenia z usługą 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.

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