Note
Azure Databricks Excel 外掛在 Azure 政府或 Azure 中國地區都無法取得。
Azure Databricks Excel 外掛將你的Azure Databricks工作區連接到 Microsoft Excel,將受管控的 Lakehouse 資料直接帶入試算表。 該外掛在 Excel 網頁版 以及 Windows 和 macOS 桌面版本中均獲得全面支援。
本頁說明了在 Microsoft Excel 中設定 Azure Databricks Excel 外掛的兩種方法。 此外掛程式使用單一登入(SSO)驗證來連接您的 Azure Databricks 工作區,並支援具有資料治理與存取控制功能的 Unity Catalog。
先決條件
在安裝 Excel 外掛前,請確認你具備以下條件:
- 啟用 Unity 目錄後,可存取 Azure Databricks 工作區。
- 每個 Excel 應該連接的 Azure Databricks 工作區之 workspace 網址。
- 你有 Azure Databricks 的 SQL 存取權限,至少可以對 SQL 倉庫使用權限。 為了低延遲匯入資料,你也可以使用 Lakehouse//RT 資料倉儲,它只支援匯入。
- 在工作區中讀取 Unity Catalog 資料表的權限。
- 以下 Excel 版本之一:
- Mac 版 Excel 2019 或更新版本
- Excel on Windows(Microsoft 365)
- 網路版Excel
- Mac 上的 Excel(Microsoft 365)
- 如果你使用防火牆或雲端安全平台,請將外掛程式檔案中包含的 Azure Databricks 工作區 URL 列入允許清單。
- 如果您的 Microsoft Entra 租戶阻擋第三方應用程式的使用者同意,Microsoft Entra 管理員必須先授權 Azure Databricks 單一登入企業應用程式,使用者才能使用帳戶選擇器登入。 若使用者直接輸入工作區網址登入,則無需此操作。 登入時請查看 「需要管理員批准」訊息。
設定外掛檔案
Note
如果你是透過 Microsoft Marketplace 部署外掛的管理員,請跳過此部分。 市集部署是用 PowerShell 來設定工作區存取,而不是外掛檔案。 請參考 透過 Microsoft Marketplace 部署。
這個外掛檔案是一個小型連接器檔案,告訴 Excel 如何安全連接 Azure Databricks。 它就像一個數位握手,確保外掛程式正確載入,並且每次開啟 Excel 時都能保持更新。
下載並設定外掛檔案以使用 Azure Databricks Excel 外掛。 一個外掛檔案可以連接到多個 Azure Databricks 工作空間。
下載Azure Databricks Excel 增益集檔案:
編輯外掛檔案,並在 區段內指定你的
<AppDomain>作為AppDomains。 你的工作區 URL 是你用來存取瀏覽器中 Azure Databricks 工作區的基礎網址。 若要在多個 Azure Databricks 工作區間切換,請將每個工作區的 URL 加入外掛檔案。要用 自訂 URL 登入,請將自訂 URL 與對應的工作區 URL 分別作為獨立
<AppDomain>條目加入,如下範例所示。 登入可以重定向到任一 URL。<AppDomains> <!-- DO NOT CHANGE --> <AppDomain>https://www.databricks.com</AppDomain> <AppDomain>https://login.databricks.com</AppDomain> <!-- ADD WORKSPACE URLS AS SHOWN BELOW; PUT EACH WORKSPACE URL IN ITS OWN <AppDomain> TAG --> <!-- EXAMPLE --> // highlight-next-line <AppDomain>https://adb-<workspace1-id>.<random-number>.azuredatabricks.net</AppDomain> // highlight-next-line <AppDomain>https://adb-<workspace2-id>.<random-number>.azuredatabricks.net</AppDomain> <!-- TO USE A CUSTOM URL, ADD BOTH THE CUSTOM URL AND ITS ASSOCIATED WORKSPACE URL --> // highlight-next-line <AppDomain>https://<custom-url>.azuredatabricks.net</AppDomain> </AppDomains>Note
將工作區網址貼上為純文字,且不需格式化。 在大多數文字編輯器中,請使用
Ctrl+Shift+V(Windows)或Command+Shift+V(macOS)。儲存您的變更。 確認檔案格式正確
.xml。
選項一:從 Microsoft 365 系統管理中心 部署
作為全域管理員,你可以將 Azure Databricks Excel 外掛程式部署給組織內的使用者。 你可以使用外掛檔案部署為自訂應用程式,或從 Microsoft Marketplace 安裝。
若要以 Microsoft 365 管理員身份安裝 Azure Databricks Excel 外掛,您必須擁有權限 global admin 。 作為管理員,你可以決定組織中哪些使用者可以使用外掛程式。想了解更多關於 Microsoft 365 全域管理員的資訊,請參閱 Microsoft 文件。
點此存取 Microsoft 365 系統管理中心。
Note
Databricks 建議將 Azure Databricks Excel 外掛程式部署為自訂應用程式。
以自訂應用程式部署
用自訂清單檔案部署外掛程式。 下載並設定必要條件中提供的附加元件檔案。
- 在 Microsoft 365 管理中心,點選「 設定 > 整合應用程式 」並點擊 「附加元件 」連結。
- 點選 部署外掛 ,然後點 選下一步。
- 點選 「上傳自訂應用程式 」作為部署新外掛的選項。
- 在 應用程式類型 下拉選單中,選擇 Office 外掛。
- 選擇從 裝置上傳清單檔案(.xml)這個選項。 點選 選擇檔案 並上傳附加檔案。
- 選擇哪些使用者應該能存取該外掛。
- 按一下[部署]。
Note
如果 Office 外掛選項未顯示,請確保您的組織符合 Microsoft 365 集中部署的需求,例如 Exchange Online。 請參閱 Microsoft 文件中的「判斷集中部署外掛程式是否適合您組織」。
關於上傳 Azure Databricks Excel 外掛的詳細步驟,請參閱 Microsoft 文件。
從 Microsoft Marketplace 部署
從 Microsoft Marketplace 安裝外掛,並使用 PowerShell 設定工作區存取權限。 單純安裝外掛並不會讓它連接到你的 Azure Databricks 工作區。 請依照以下所有步驟操作,包括使用 PowerShell 將工作區網址列入允許名單。
Prerequisites
- PowerShell 已安裝在你的電腦上。
- 你必須以管理員身份執行 Windows PowerShell。
安裝外掛
- 在Microsoft 365 系統管理中心中,進入 Settings > Integrated Apps,點選 Get Apps 連結。
- 搜尋「Azure Databricks Add-in for Excel」。
- 點擊立即取得。
- 在「指派使用者」中選擇「只用我」來部署該外掛到自己身上。
- 按一下[部署]。
關於從 Microsoft Marketplace 部署 Azure Databricks Excel 外掛的詳細步驟,請參閱 Microsoft 文件。
設定工作區存取權限
安裝外掛後,使用 PowerShell 允許列出你的 Azure Databricks 工作區網址。
Note
PowerShell 連接到 Office 365 管理中心可能會逾時。如果指令失敗,請重新開啟 PowerShell,並執行 Connect-OrganizationAddInService 重新連線。
打開 PowerShell 並以管理員身份執行。 更多資訊請參閱 Microsoft 文件。
安裝並匯入 Office 365 集中式部署模組:
Install-Module -Name O365CentralizedAddInDeployment Import-Module O365CentralizedAddInDeployment以管理員身份登入並登入您的 Office 365 租戶:
Connect-OrganizationAddInService確認外掛已經部署。 Excel 的 Azure Databricks 外掛應該會出現在清單中。
Get-OrganizationAddIn如果外掛沒有出現,可能需要重新部署,或仍在部署中。
將 Azure Databricks 工作區 URL 加入允許清單。 把每個
<workspace-url>都替換成你想允許的工作區網址。 你可以包含任意數量的工作區網址。 為支援 自訂 URL,請同時包含自訂 URL 及相關的工作區 URL。Set-OrganizationAddInOverrides -ProductId d75dbea5-bf93-49b8-9a49-bdf4e9d6f052 ` -AppDomains "https://adb-<workspace1-id>.<random-number>.azuredatabricks.net", "https://adb-<workspace2-id>.<random-number>.azuredatabricks.net", "https://<custom-url>.azuredatabricks.net"Azure Databricks 的產品 ID 是
d75dbea5-bf93-49b8-9a49-bdf4e9d6f052。即使工作區 URL 成功被允許列出,這個指令也可能回傳
There was an error uploading the Add-In。 在再次執行指令前,先完成下一步檢查允許清單是否已套用。確認允許名單正確。 你允許列出的工作區網址應該會出現在該
AppDomains區塊裡。Get-OrganizationAddInOverrides -ProductId d75dbea5-bf93-49b8-9a49-bdf4e9d6f052
測試外掛
- 在 Excel 裡,找到 Azure Databricks 插件。
- 登入並連接到你允許列出的工作區之一。
Note
允許清單的變更可能需要一些時間來同步。如果認證失敗,請確認你正在連接到已加入允許清單的工作區。 如果工作區正確,關閉 Excel,稍後再試一次。
部署到貴組織
- 在 Microsoft 365 管理中心,點到 設定 > 中的整合應用程式。
- 選擇你安裝並設定的 Azure Databricks 外掛。
- 點選 「使用者 」標籤,選擇是部署給整個組織還是特定使用者群組。
Note
作為管理員,請將你已允許列出的工作區所關聯的帳號名稱分享給計劃使用 Azure Databricks Excel 外掛的使用者。 請參見「登入外掛」。
選項二:以個人使用者身份部署
安裝步驟會依你的 Excel 平台而異。 下載並設定必要條件中提供的附加元件檔案。
Excel 網頁版
要安裝並連接 Excel 網頁版 中的 Excel 外掛,請執行以下步驟:
- 打開網頁版 Excel,建立或開啟一本工作簿。
- 在「首頁」標籤下,點選「進階>」。
- 點擊 上傳我的外掛。
- 上傳外掛檔案。
- 按一下 [上傳] 。
- 從 Add-ins 選單中找到並點擊 Azure Databricks 的外掛。
- 登入你的 Azure Databricks 帳號。 如果有錯誤,請務必啟用彈出視窗。
- 如果你設定了多個工作區網址,請選擇想要的 Azure Databricks 帳號名稱。 只有當 URL 在同一帳號內時,你才需要選擇特定的工作區。 欲了解更多帳號名稱資訊,請參閱 「尋找您的帳號ID」。
Excel 桌面版(Windows)
不要從 商店 分頁安裝外掛。這樣安裝的外掛不會連上你的工作區。 從 Excel Desktop for Windows 的共用資料夾標籤安裝 Excel 外掛:
- 在你本機硬碟上建立一個命名
Manifest的資料夾(例如,C:\Manifest)。 - 將外掛檔案複製到資料夾。
C:\Manifest - 打開資料夾屬性並分享資料夾:
- 以滑鼠右鍵按下
Manifest資料夾,然後選取 [ 屬性]。 - 點擊 分享>,然後添加自己作為擁有讀寫權限的使用者。
- 以滑鼠右鍵按下
- 打開 Excel 桌面。
- 設定 Excel 讓它信任清單資料夾:
- 點選 檔案>選項>信任中心>信任中心設定。
- 在側邊欄,點擊 「受信任的附加目錄」。
- 在 目錄網址中,輸入外掛檔案所在的共享資料夾路徑(例如,
\\YourComputerName\Manifest)。 - 點擊 新增目錄。
- 選擇「 選單中顯示 」的勾選框。
- 按一下 [確定] 以儲存變更。
- 重新啟動 Excel 桌面。
- 在「首頁」標籤下,點選 「附加元件>」「更多附加元件」。
- 在 Shared Folder 下,選擇 Azure Databricks Add-in for Excel。
- 完成您的 Azure Databricks 帳號登入流程。
- 如果你設定了多個工作區網址,請選擇想要的 Azure Databricks 帳號名稱。 只有當 URL 在同一帳號內時,你才需要選擇特定的工作區。 欲了解更多帳號名稱資訊,請參閱 「尋找您的帳號ID」。
Excel 桌面(macOS)
要在 macOS 的 Excel Desktop 安裝 Excel 外掛,請執行以下步驟:
將外掛檔案複製到你的 Microsoft Office 增益集 資料夾。 如果
wef資料夾不存在,就建立它。/Users/<your-username>/Library/Containers/com.microsoft.Excel/Data/Documents/wef開啟或重新啟動 Excel 桌面。
在導航列中,點選「 Add-ins>My Add-ins」。
點選 Azure Databricks 外掛。
完成您的 Azure Databricks 帳號登入流程。
如果你設定了多個工作區網址,請選擇想要的 Azure Databricks 帳號名稱。 只有當 URL 在同一帳號內時,你才需要選擇特定的工作區。 欲了解更多帳號名稱資訊,請參閱 「尋找您的帳號ID」。
登入外掛
如果你組織中的管理員部署了 Azure Databricks Excel 外掛,請登入並從 Excel 連接你的 Azure Databricks 工作區。
在 Excel 中,在 Home 標籤下,點擊 Azure Databricks Add-in。
首次登入時,請使用以下選項之一連接工作區:
點擊登入並完成驗證流程,即可取得Azure Databricks Excel外掛的存取權。
在你第一次登入後,外掛會記住你的工作區。 在後續登入時,從下拉選單選擇工作區,或使用上述任一選項連接到不同的工作區。
如果你使用 Microsoft Entra ID 認證且出現「需要管理員批准」訊息,必須先由 Microsoft Entra 管理員批准 Azure Databricks 企業應用程式,才能登入。 登入時請查看 「需要管理員批准」訊息。
變更 Azure Databricks 工作區
如果你的外掛檔案指定了多個 Azure Databricks 工作區,你可以在這些工作區之間切換。 欲了解更多資訊,請參閱 設定外掛檔案。
若要連接不同的 Azure Databricks 工作空間,請執行以下步驟:
- 在 Azure Databricks 外掛窗格右上角,點擊計算選擇器旁的三點選單。
- 點擊 「變更工作區」。
- 選擇你工作區所在的帳號,如果有提示就選擇工作區,然後登入。
故障排除
無法匯入資料或確認按鈕顯示為灰色
如果您無法匯入資料,或 確認 按鈕呈灰色,通常是因為從 Microsoft Marketplace 安裝外掛時,您的工作區尚未設定。 解決方法是先卸載該外掛,然後用外掛檔案重新安裝。
要解除安裝外掛:
- 在 Excel 的常用頁籤上,按一下增益集,然後按一下更多增益集。在 Excel 網頁版 中,按一下增益集>管理。
- 打開 「我的外掛 」分頁。
- 點擊 Azure Databricks 外掛上的三個點,點取移除,或如果你用的是 Excel 網頁版 就點刪除,然後確認。
接著請參考 選項二:以個人使用者身份部署 ,並使用外掛檔案重新安裝。 如果你是要為組織部署的管理員,請改為參考 Deploy as a custom app。
登入時顯示「認證進行中」訊息
如果你在嘗試從外掛登入 Azure Databricks 時看到「認證進行中」視窗,表示你的工作區可能沒有正確加入自訂外掛檔案。 請確認你已在<AppDomains>正確配置工作區。
登入時出現「需要管理員批准」訊息
當你從 Excel 增益集 登入 Azure Databricks 工作空間時,會出現以下「需要管理員批准」訊息,因為 Microsoft Entra 租戶正在阻擋 Azure Databricks 應用程式的使用者同意。 這只適用於你用帳號選擇器登入時(;login.databricks.com);為了避免這種情況,請在登入時直接輸入你的工作區網址。 若未獲得管理員同意,Microsoft Entra ID 仍會繼續阻擋登入流程,即使你有直接工作區存取權。
為解決此問題,具備適當管理員角色的 Microsoft Entra 使用者必須授權租戶管理員同意 Azure Databricks 企業應用程式。
請請 Microsoft Entra 管理員點選以下連結。 請用你的 Microsoft Entra 租戶 ID 替換{TENANT_ID}:
https://login.microsoftonline.com/{TENANT_ID}/adminconsent?client_id=aaec40b0-c0ae-4211-a98b-6fc160abb71b
若連結失敗,管理員可手動授權:
- 在 Microsoft Entra 系統管理中心,前往 Entra ID>Enterprise apps>All Applications,找到用於單一登入的Azure Databricks企業應用程式。 要識別應用程式,請搜尋應用程式 ID
aaec40b0-c0ae-4211-a98b-6fc160abb71b。 - 請授予 Azure Databricks 企業應用程式所請求的權限管理員同意:
- 在 安全性下,點選 權限。
- 點選 授予管理員同意。
詳細說明請參閱 Microsoft 文件。
無法使用資源
如果你無法在 Azure Databricks 外掛中使用 Azure Databricks 資源,例如 SQL 倉庫,請根據你使用的 Excel 版本,嘗試以下其中一種方法:
- Excel 網頁版:重新啟動試算表或更換工作區,然後登入同一個工作區。 請參閱 更改 Azure Databricks 工作空間。
- Excel 桌面版:點擊右上角的資訊圖示並選擇重新載入,重新載入外掛程式。