Databricks

注意

此連接器由 Databricks 擁有和提供。

總結

Property Value
連接器 Databricks 圖示 Databricks
產品 Power BI(語意模型)
Power Query Online
發行狀態 一般可用性
類別 Database
驗證類型 Databricks 客戶端認證
OAuth (OIDC)
個人存取令牌
資料來源類型 Databricks多雲
函數參考文檔 DatabricksMultiCloud.Catalogs
DatabricksMultiCloud.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,請採取以下步驟:

  1. 在 [獲取數據] 體驗中,搜尋 Databricks,以篩選 Databricks 連接器。 如果您使用 OAuth 進行驗證,應該在此專門針對 AWS 上運行的 Databricks SQL 資料庫使用 Databricks 連接器。

    Databricks Cloud 的「取得資料」對話截圖。

  2. 為您的 Databricks SQL 倉儲提供 伺服器主機名 和 HTTP 路徑。 如需查閱「伺服器主機名」和「HTTP 路徑」的指示,請參閱 設定 Databricks ODBC 和 JDBC 驅動程式。 根據此輸入這項資訊。 您可以選擇性地在 [進階選項] 底下提供預設目錄和/或資料庫,。 選擇 [確定] 以繼續。

    Databricks SQL Warehouse 連線欄位的截圖。

  3. 提供認證以向 Databricks SQL 倉儲進行驗證。 您有三個選項可取得認證:

    注意

    一旦你輸入了特定 Databricks SQL Warehouse 的憑證,Power BI Desktop 會快取並在後續連線嘗試中重複使用相同的憑證。 您可以移至 >> 數據源設定。 詳細資訊:變更驗證方法

  4. 成功連線之後,Navigator 會顯示叢集上可用的數據。 你可以選擇 Transform Data來使用 Power Query 轉換資料,或選擇 Load在桌面Power Query載入資料。

    Power Query導航器將Databricks雲端資料載入桌面應用程式的圖片。

從 Power Query Online 連線

要從 Power Query Online 連接 Databricks,請採取以下步驟:

  1. 在取得數據體驗中選取 [Databricks] 選項。 不同的應用程式則有不同的方式來進入 Power Query Online 取得資料的體驗。 想了解如何透過應用程式獲得Power Query線上數據體驗,請造訪 資料來源。

    請使用搜尋方塊篩選可用的 Databricks 連接器。 為您的 Databricks SQL 倉儲選取 Databricks 連接器。

    Databricks 連接器選項的截圖在 Power Query 中

  2. 輸入 databricks SQL 倉儲的 Server 主機名,並 HTTP 路徑。 如需查閱「伺服器主機名」和「HTTP 路徑」的指示,請參閱 設定 Databricks ODBC 和 JDBC 驅動程式。 您可以選擇性地在 [進階選項] 底下提供預設目錄和/或資料庫,。

    Databricks 線上服務的連線設定與憑證的截圖。

  3. 提供認證以向 Databricks SQL 倉儲進行驗證。 認證有三個選項:

    • 基本。 使用使用者名稱和密碼進行驗證時,請使用此選項。 如果您的組織/帳戶使用 2FA/MFA,則無法使用此選項。
    • 帳戶金鑰。 使用個人存取令牌進行驗證時,請使用此選項。 如需產生個人存取令牌(PAT)的指示,請參閱 個人存取令牌。
    • 組織帳戶。 使用 OAuth 進行驗證時,請使用此選項。 使用瀏覽器彈出視窗登入您的組織帳戶。
  4. 成功連線之後,Navigator 隨即出現,並顯示伺服器上可用的數據。 在導覽器中選取您的數據。 然後選擇 Next 來Power Query轉換資料。

     截圖,顯示Power Query導航器將 Databricks 雲端資料載入線上應用程式。

其他資訊

Arrow 資料庫連線驅動程式連接器實作

Power BI 中 Databricks 連接器的 Arrow 資料庫連接(ADBC) 驅動程式自 2026 年 10 月 15 日起正式可用。 要在 Power BI Desktop 中使用,請更新到最新版本。 你也可以向 Databricks 提交產品回饋 。

若要切換至 ADBC 驅動程式:

  1. 在 Power BI 中開啟你想要的儀表板。

  2. 選擇轉換數據。

  3. 在Query選項區塊中選擇進階編輯器。

  4. 指定 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