注意
此連接器由 Databricks 擁有和提供。
總結
| Property | Value |
|---|---|
| 連接器 |
Databricks |
| 產品 | Power BI(語意模型) Power Query Online |
| 發行狀態 | 一般可用性 |
| 類別 | Database |
| 驗證類型 | Databricks 客戶端認證 OAuth (OIDC) 個人存取令牌 |
| 資料來源類型 | Databricks多雲 |
| 函數參考文檔 | DatabricksMultiCloud.CatalogsDatabricksMultiCloud.Query |
注意
某些功能可能會存在於一個產品中,但由於部署排程和主機特定功能,而不存在於其他產品中。
Important
Power BI 中 Databricks 連接器的 Arrow 資料庫連接(ADBC)驅動程式自 2026 年 10 月 15 日起已正式提供。 此連接器正從嵌入式的 Simba Spark ODBC 驅動程式過渡到 Databricks 的 ADBC 驅動程式。 有關遷移指引、關鍵日期及管理控制,請參閱從 ODBC 轉換至 ADBC 驅動程式於 Power BI 與 Fabric。
先決條件
此連接器僅適用於運行在 AWS 上並使用 OAuth 的 Databricks SQL 倉儲。 如果你用的是Azure Databricks,請使用Azure Databricks接頭。 如果你沒有在 Databricks SQL Warehouse(AWS 或 GCP 上)使用 OAuth,也請使用 Azure Databricks 連接器。 不支援 Databricks Community Edition。
支援的功能
- 進口
- DirectQuery(Power BI 語意模型)
Parameters
進入點:DatabricksMultiCloud.Catalogs
所需參數數: 2
| Parameter | 顯示名稱 | Required | 類型 | Group | 描述 | 範例值 | 可空值 |
|---|---|---|---|---|---|---|---|
| 主持人 | 伺服器主機名稱 | Yes | 收發簡訊 | Databricks 伺服器的主機名稱。 | 「example.azuredatabricks.net」 | false | |
| httpPath | HTTP 路徑 | Yes | 收發簡訊 | 叢集的 HTTP 路徑。 | “/sql/1.0/warehouses/abcdef1234567890” | false | |
| options | 進階選項 | No | 可以為空的記錄 | 進階選項 | true |
在 options 中的欄位
| Field | 顯示名稱 | Required | 類型 | Group | 描述 | 宣告為預設 | 允許的值 | 範例值 | 可空值 | Optional | 允許的值元資料 | 已宣告的允許值 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 選項.目錄 | 默認目錄 | No | 收發簡訊 | 進階選項 | 選擇連線的預設 catalog。 | false | true | |||||
| 選項.資料庫 | Database | No | 收發簡訊 | 進階選項 | 限制連線到所選資料庫。 這可能會讓列出表格的速度更快,但會防止存取多個不同資料庫的查詢進行查詢摺疊。 | false | true | |||||
| options.QueryTags | 查詢標籤 | No | 收發簡訊 | 進階選項 | 用於追蹤 system.query.history 資料表查詢的鍵值標籤。 | "tag1:value1,tag2:value2" | false | true | ||||
| options.EnableAutomaticProxyDiscovery | 自動代理發現 | No | 收發簡訊 | 進階選項 | 這能實現 Windows 系統範圍內的自動代理發現。 | 「啟用」(啟用);「停用」(停用(預設狀態)) | false | true | [{"Metadata": {"Documentation.Caption": "啟用", "Documentation.Name": "AutomaticProxyDiscoveryFlag.Enabled"}, "Value": "啟用"}, {"Metadata": {"Documentation.Caption": "停用(預設)", "Documentation.Name": "AutomaticProxyDiscoveryFlag.Disabled"}, "Value": "停用"}] | ["啟用", "停用"] | ||
| options.Implementation | Implementation | No | 收發簡訊 | 進階選項 | 請使用「2.0 (beta)」來指定 ADBC。 「預設」值會利用環境設定來決定要使用哪個驅動程式。 | "2.0" | 「2.0」(2.0 - ADBC);null(系統預設) | false | true | ["2.0", null] | ||
| options.Protocol | Protocol | No | 收發簡訊 | 進階選項 | 指定 ADBC 驅動程式所使用的協定。 選擇「REST (SEA)」以使用陳述式執行 API。 未設定時,會使用驅動程式預設值(Thrift)。 | null | null(預設);「rest」(REST(SEA)) | false | true | [null, "休止"] |
從 Power Query Desktop 連線
要從 Power Query Desktop 連接 Databricks,請採取以下步驟:
在 [獲取數據] 體驗中,搜尋 Databricks,以篩選 Databricks 連接器。 如果您使用 OAuth 進行驗證,應該在此專門針對 AWS 上運行的 Databricks SQL 資料庫使用 Databricks 連接器。
為您的 Databricks SQL 倉儲提供 伺服器主機名 和 HTTP 路徑。 如需查閱「伺服器主機名」和「HTTP 路徑」的指示,請參閱 設定 Databricks ODBC 和 JDBC 驅動程式。 根據此輸入這項資訊。 您可以選擇性地在 [進階選項] 底下提供預設目錄和/或資料庫,。 選擇 [確定] 以繼續。
提供認證以向 Databricks SQL 倉儲進行驗證。 您有三個選項可取得認證:
Databricks 客戶端認證。 如需獲得生成 Databricks OAuth M2M 用戶端憑證的指引,請參閱 Databricks OAuth M2M。
個人存取令牌。 如需產生個人存取令牌(PAT)的指示,請參閱 個人存取令牌。
OAuth (OIDC)。 使用瀏覽器彈出視窗登入您的組織帳戶。
注意
一旦你輸入了特定 Databricks SQL Warehouse 的憑證,Power BI Desktop 會快取並在後續連線嘗試中重複使用相同的憑證。 您可以移至 >> 數據源設定。 詳細資訊:變更驗證方法
成功連線之後,Navigator 會顯示叢集上可用的數據。 你可以選擇 Transform Data來使用 Power Query 轉換資料,或選擇 Load在桌面Power Query載入資料。
從 Power Query Online 連線
要從 Power Query Online 連接 Databricks,請採取以下步驟:
在取得數據體驗中選取 [Databricks] 選項。 不同的應用程式則有不同的方式來進入 Power Query Online 取得資料的體驗。 想了解如何透過應用程式獲得Power Query線上數據體驗,請造訪 資料來源。
請使用搜尋方塊篩選可用的 Databricks 連接器。 為您的 Databricks SQL 倉儲選取 Databricks 連接器。
Databricks 連接器選項的截圖在 Power Query 中 輸入 databricks SQL 倉儲的 Server 主機名,並 HTTP 路徑。 如需查閱「伺服器主機名」和「HTTP 路徑」的指示,請參閱 設定 Databricks ODBC 和 JDBC 驅動程式。 您可以選擇性地在 [進階選項] 底下提供預設目錄和/或資料庫,。
提供認證以向 Databricks SQL 倉儲進行驗證。 認證有三個選項:
- 基本。 使用使用者名稱和密碼進行驗證時,請使用此選項。 如果您的組織/帳戶使用 2FA/MFA,則無法使用此選項。
- 帳戶金鑰。 使用個人存取令牌進行驗證時,請使用此選項。 如需產生個人存取令牌(PAT)的指示,請參閱 個人存取令牌。
- 組織帳戶。 使用 OAuth 進行驗證時,請使用此選項。 使用瀏覽器彈出視窗登入您的組織帳戶。
成功連線之後,Navigator 隨即出現,並顯示伺服器上可用的數據。 在導覽器中選取您的數據。 然後選擇 Next 來Power Query轉換資料。
其他資訊
Arrow 資料庫連線驅動程式連接器實作
Power BI 中 Databricks 連接器的 Arrow 資料庫連接(ADBC) 驅動程式自 2026 年 10 月 15 日起正式可用。 要在 Power BI Desktop 中使用,請更新到最新版本。 你也可以向 Databricks 提交產品回饋 。
若要切換至 ADBC 驅動程式:
在 Power BI 中開啟你想要的儀表板。
選擇轉換數據。
在Query選項區塊中選擇進階編輯器。
指定 ADBC 的
Implementation="2.0"。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
Databricks