在 Azure Databricks Excel 外掛中排程自動資料刷新

Important

這項功能目前處於 公開預覽版。

Note

Azure Databricks Excel 外掛在 Azure 政府或 Azure 中國地區都無法取得。

排程刷新會自動依照排程執行匯入 Excel 工作簿的資料保持最新。 你可以為儲存的查詢、資料表或樞透分析表匯入建立排程,選擇每次刷新時執行的 SQL 倉庫,並檢視 Azure Databricks Excel 外掛的近期執行紀錄。

欲了解排程刷新如何與Microsoft 365連結,以及適用哪些網路安全功能,請參閱Azure Databricks Excel附加元件架構與安全性。

Prerequisites

在建立排程刷新前,請確保:

排程刷新會使用建立排程者的 Azure Databricks 身份和 Microsoft 憑證執行。 保持這些憑證有效,讓 Azure Databricks 可以查詢資料並更新工作簿。

Microsoft 權限

您的 Excel 增益集檔案必須在 AppDomains 區段中包含下列網域。 如果您在排程更新前安裝了 Excel 外掛,請將網域加入外掛檔案或重新下載該檔案。 請參閱設定 Azure Databricks Excel 插件。

<AppDomain>https://login.microsoftonline.com</AppDomain>

增益集會要求下列 Microsoft 權限,您必須同意這些權限,排程重新整理才能存取並更新活頁簿:

  • Files.ReadWrite閱讀並更新你的工作簿。
  • offline_access:在你未積極登入時,持續執行排程刷新。

建立排程

為從 Azure Databricks Excel 外掛匯入的任何已儲存的查詢、資料表或樞紐分析表建立排程刷新。

  1. 打開Azure Databricks Excel插件。
  2. 前往「已儲存匯入」。
  3. 找到你想自動刷新的匯入。
  4. 選擇匯入旁邊的行事曆按鈕。
  5. 檢閱 資產詳細資料,以確認您已選取正確的查詢、資料表或樞紐分析表。
  6. 在 管理排程 標籤中,輸入一個描述性的 排程名稱。
  7. 選擇 排程類型。 請參閱 間隔 與 排程:
    • 間隔:每隔數分鐘、小時、天或週刷新一次。
    • 時間表:選擇以行事曆為基礎的節奏與時間,例如每天特定時間或每週特定日期。
  8. 如果你選擇 了排班,請確認 時區。 初始時區是根據您瀏覽器的本機設定決定的。
  9. 在 SQL 倉庫中,選擇執行查詢的倉庫。
  10. 選擇 建立排程。

排程建立後,儲存匯入的行事曆按鈕會變成帶有時鐘的行事曆圖示。

一個已儲存的匯入,顯示帶有時鐘的行事曆圖示,顯示排程刷新,並附上匯入地點及最後刷新時間。

間隔

當刷新應該在固定一段時間後重複時,使用 間隔 。 輸入一個數字,選擇 分鐘、 小時、 天或 週。

可用的間隔範圍如下:

  • 1 到 120 分鐘
  • 1 到 72 小時
  • 1至31天
  • 1 到 8 週

若要刷新必須在特定平日和時間執行,請使用 排程 而非每週間隔。

選擇區間排程類型的「管理排程」標籤,顯示「每個欄位」、SQL 倉庫選擇器及「建立排程」按鈕。

排程

當重新整理必須在特定日曆時間點執行時,請使用 Schedule。 根據節奏,你可以選擇:

  • 頻率,例如分鐘、小時、天、週或月
  • 當天的時間
  • 每週排程的星期幾
  • 每月排班的月份日期
  • 時區

時間會在所選的排班時區進行評估。 運行歷史時間戳會依據檢視者的地區設定顯示。

選擇「管理排程」分頁,並選擇「排程排程」類型,顯示節奏、時間及時區選擇器。

更新現有的排程

更改你已經建立的排程表名稱、節奏、時區或 SQL 倉庫。

  1. 從 已儲存的匯入中,選擇匯入的「帶時鐘的行事曆」按鈕。
  2. 在 管理排程 標籤中,更改排程名稱、排程頻率、時區或 SQL Warehouse。
  3. 選擇 更新排程。

更新底層已儲存的匯入也會將其查詢、參數、篩選條件及列限制與排程重新整理同步。 下一次執行則使用更新後的匯入定義。

檢視執行記錄

檢查排程匯入近期重新整理執行的結果,包括每次執行的狀態、持續時間及任何失敗詳細資料。

  1. 開啟已儲存匯入作業的排程。
  2. 選擇「 跑步歷史」 標籤。
  3. 查看最近的執行紀錄。 每個項目都會顯示完成時間、狀態及所需時間。
  4. 展開執行以查看更多細節,包括刷新失敗時的錯誤訊息。

執行狀態包括:

  • OK:重新整理已成功完成。
  • 跑步:更新仍在進行中。
  • 失敗:刷新未完成。 展開此執行以查看可用的失敗詳細資料。

如果排程尚未執行,索引標籤會顯示 尚無執行記錄。

刪除已排程的匯入

排程刷新不提供暫停行程或只刪除行程的獨立選項。

若要從 Excel 增益集中停止排程,請刪除已儲存的匯入:

  1. 在 已儲存的匯入 中,開啟該匯入項目的動作選單。
  2. 選擇 刪除。

刪除已儲存的匯入也會刪除其相關的排定重新整理作業,並從活頁簿中移除已儲存的匯入設定。

Troubleshooting

如果排定的重新整理未執行,或活頁簿未更新,請使用下列各節找出並解決最常見的原因。

您的 Microsoft 憑證已過期

排定重新整理需要透過你的 Microsoft 帳戶存取活頁簿。 如果增益集顯示以下訊息,表示您的憑證已過期:

您的 Microsoft 認證已過期。 登入以讓排定的重新整理持續執行。

選擇 Microsoft 登入並完成登入流程。 即使憑證已過期,排程仍可能顯示為已設定,但重新整理作業在恢復存取權之前,無法更新工作簿。

排程重新整理失敗

如果執行作業顯示為 失敗 狀態,請依序執行下列檢查以找出原因:

  1. 打開排程並選擇 「執行歷程」。
  2. 展開失敗的執行,並檢視錯誤訊息。
  3. 確認您的 Microsoft 帳戶仍保持連結。
  4. 確認該工作簿仍在 OneDrive 或 SharePoint 中,且你的帳號能編輯它。
  5. 確認所選的 SQL 倉庫是否可用,且你能執行原始查詢。
  6. 確認您仍可存取來源資料表及其他引用的資料。
  7. 如果匯入時使用 Excel 儲存格參考作為參數或過濾器,請確認所參考的工作表和儲存格仍然存在。

作業簿未更新

如果執行報告成功但工作簿資料過時,請確認工作簿仍在預期位置且可存取:

  1. 從 OneDrive 或 SharePoint 位置開啟工作簿。
  2. 請確認自上次更新行程以來,該工作簿未被移動、改名或更換。
  3. 如果被要求,請重新連結你的 Microsoft 帳戶。
  4. 查看 運行歷史 以獲取最新的狀態與錯誤細節。