Azure Databricks

備註

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

總結

Property Value
連接器 Azure Databricks 圖示 Azure Databricks
產品 Power BI（語意模型）
Power Query Online
發行狀態 一般可用性
類別 Database
驗證類型 Azure Active Directory
Databricks 客戶端認證
個人存取令牌
產品專屬驗證 服務主體（Power BI / Fabric）
Workspace Identity（Power BI / Fabric）
資料來源類型 Databricks
函數參考文檔 Databricks.Catalogs
Databricks.Contents
Databricks.Query

Important

Power BI 的 Azure Databricks 連接器現在支援 Arrow 資料庫連接（ADBC） 驅動程式。 此連接器正從嵌入式的 Simba Spark ODBC 驅動程式過渡到 Databricks 的 ADBC 驅動程式。 有關遷移指引、關鍵日期及管理控制，請參閱從 ODBC 轉換至 ADBC 驅動程式於 Power BI 與 Fabric。

Prerequisites

對於私人網路，你需要實作以下網路設定：

  • *.blob.core.windows.net* 和 *.store.core.windows.net 需要在你的網路環境中開啟。
  • 這份憑證下載與撤銷清單 也需要加入您的允許清單。
  • 如果您的 Databricks 工作空間儲存帳號啟用防火牆支援，您必須設定虛擬網路資料閘道或本地資料閘道，才能允許私人存取儲存帳號。 這確保 Fabric Power BI 服務 能持續存取工作區儲存帳號，且 CloudFetch 也能正常運作。 或者，你也可以用設定 EnableQueryResultDownload=0停用 CloudFetch。

支援的功能

  • 進口
  • DirectQuery（Power BI 語意模型）

Parameters

進入點：Databricks.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 允許值的中繼資料 已宣告的允許值
options.Catalog 默認目錄 No 收發簡訊 進階選項 選擇連線的預設型錄。 false true
options.Database Database No 收發簡訊 進階選項 限制連線到所選資料庫。 這可能會讓列出表格的速度更快，但對於存取多個不同資料庫的查詢，將無法進行查詢摺疊。 false true
options.QueryTags 查詢標籤 No 收發簡訊 進階選項 用於追蹤 system.query.history 資料表查詢的鍵值標籤。 tag1:value1,tag2:value2 false true
options.EnableAutomaticProxyDiscovery 自動代理發現 No 收發簡訊 進階選項 這會啟用 Windows 系統範圍內的自動 Proxy 自動探索。 「啟用」（啟用）;「停用」（停用（預設狀態）） false true [{"Metadata": {"Documentation.Caption": "啟用", "Documentation.Name": "AutomaticProxyDiscoveryFlag.Enabled"}, "Value": "enabled"}, {"Metadata": {"Documentation.Caption": "停用（預設）", "Documentation.Name": "AutomaticProxyDiscoveryFlag.Disabled"}, "Value": "disabled"}] [「啟用」、「停用」]
options.Implementation Implementation No 收發簡訊 進階選項 請使用「2.0 （beta）」來指定 ADBC。 「預設」值會利用環境設定來決定要使用哪個驅動程式。 "2.0" 「2.0」（2.0 - ADBC）;null（系統預設） false true ["2.0", null]
選項.通訊協定 Protocol No 收發簡訊 進階選項 指定 ADBC 驅動程式所使用的協定。 選擇「REST（SEA）」以使用陳述式執行 API。 未設定時，會使用驅動程式預設值（Thrift）。 null null（預設）;「rest」（REST（SEA）） false true [null, "休止"]

從 Power Query Desktop 連線

AWS， Azure 或 GCP

要從 Power Query Desktop 連接 Databricks，請採取以下步驟：

  1. 在「取得資料」體驗中，搜尋 Databricks，即可將 Databricks 連接器Azure Databricks列入名單。 除非你的 Databricks 代表另有指示，否則所有 Databricks SQL Warehouse 資料都請使用 Azure 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. 在取得資料體驗中選擇Azure Databricks選項。 不同的應用程式則有不同的方式來進入 Power Query Online 取得資料的體驗。 想了解如何透過應用程式獲得Power Query線上數據體驗，請造訪 資料來源。

    使用搜尋方塊篩選可用的 Databricks 連接器。 除非你的 Databricks 代表另有指示，否則所有 Databricks SQL Warehouse 資料都請使用 Azure Databricks 連接器。

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

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

    Azure Databricks 連線設定與憑證的截圖。

  3. 提供認證以向 Databricks SQL 倉儲進行驗證。 資格認證有四種選項：

    • Databricks 客戶端認證。 關於產生 Databricks OAuth M2M 用戶端憑證的說明，請參見 Databricks OAuth M2M。
    • 個人存取權杖（可用於 AWS、Azure 或 GCP）。 如需產生個人存取令牌（PAT）的指示，請參閱 個人存取令牌。
    • Azure Active Directory （只適用於 Azure）. 使用瀏覽器彈出視窗登入您的組織帳戶。
    • Service principal（只適用於 Azure）。 使用 Microsoft Entra ID 服務主體進行認證。 此選項在設定雲端或閘道連線時可用。

  4. 成功連線之後，Navigator 隨即出現，並顯示伺服器上可用的數據。 在導覽器中選取您的數據。 然後選擇 Next 來Power Query轉換資料。

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

其他資訊

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

你可以在Power BI中使用Arrow資料庫連接（ADBC）驅動程式來接Azure Databricks連接器。 當我們繼續增強並新增此連接器的新功能時，建議您升級至最新版本，以試用並 提交產品意見反應。

備註

自 2026 年 2 月起，在 Power BI Desktop 或 Power BI 服務中新建立的連線，預設會自動使用 Arrow 資料庫連接（ADBC）驅動程式。 現有連線會繼續使用 ODBC，除非你手動更新成 ADBC。

若要切換至 ADBC 驅動程式：

  1. 在 Power BI 中開啟你想要的儀表板。
  2. 選擇轉換數據。
  3. 在Query選項區塊中選擇進階編輯器。
  4. 指定 ADBC 的 Implementation="2.0"。 
    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

限制與考量

  • Azure Databricks連接器支援 web proxy。 不過，不支援 .pac 檔案中定義的自動 Proxy 設定。
  • 在 Azure Databricks 連接器中，Databricks.Query 資料來源不支援與 Power BI 語意模型的 DirectQuery 模式結合使用。
  • 上次更新時間：