本頁說明如何在 Google 試算表的 Databricks 連接器 中排程自動資料刷新,以保持匯入資料的最新狀態。 排程刷新會定期執行你儲存的查詢,並更新相應的工作表。
要求
建立 Unity 目錄連線
排程刷新需要以下事項:
- 一個名為
databricks_google_connection的 Unity Catalog 連接,由一位在 Google 試算表中負責資料管理的管理員建立。 - 連線權限
USE CONNECTION,授予需要建立或管理排程刷新的使用者。
- 作為 Azure Databricks 資料目錄管理員,在 Google Sheets 中開啟 Databricks 連接器的側邊欄。
- 點選 「已儲存匯入」 標籤。
- 點擊右上角的行事曆。
- 點擊 設定連線。
在Azure Databricks分享連線
連線建立後,將 USE CONNECTION 特權授予需要建立或管理排程刷新的使用者。 元資料庫管理員或任何具有 MANAGE 連線權限的使用者都可以授予此權限。 欲了解更多連線管理資訊,請參閱「Manage connections for Lakehouse Federation」。
建立排程
每個匯入只能分配到一個排程。 要為現有匯入建立新的排程:
在 Google 試算表的 Azure Databricks 連接器側欄,點擊 已儲存匯入 標籤。
點擊行事曆圖示,點選 新行程。
選擇匯入來建立排程。
輸入排程的名稱。
選擇您的行程 頻率 :
- 若選擇 每小時,請選取要在每小時的第幾分鐘執行重新整理。
- 對於 每日,請選擇執行刷新的時間。
- 每週,選擇星期幾及運行刷新的時間。
排班表會使用你當地的時區。
選擇用於排程查詢的 SQL 倉庫。
點擊 建立排程。
查看運行歷史與賽程詳情
要查看所有排程刷新的運行歷史,請執行以下操作:
- 在 Google 試算表的 Azure Databricks 連接器側欄,點擊 已儲存匯入 標籤。
- 點選行事曆圖示,再點 選「查看跑步紀錄」。
- 點擊特定跑步路線以查看賽程詳情。
要查看排程刷新的執行歷史與設定細節,請執行以下步驟:
在 「檢視運行歷史 」窗格中,選擇你想查看的排程名稱。 在 最近運行中,會顯示每次運行的狀態。
將滑鼠移到狀態圖示上可查看跑道 的跑道ID、 開始時間和 跑道狀態。
點擊 「檢視設定 」以查看排程細節,其中包含所選匯入與排程設定。
- 如果你正在觀看別人建立的行程表,顯示的時間就是創作者當地時區的時間。
刪除排程刷新
要刪除排程刷新,請執行以下步驟:
- 在 Google 試算表的 Azure Databricks 連接器側欄,點擊 已儲存匯入 標籤。
- 點擊行事曆圖示,然後點 選「管理行程」。
- 選擇你想刪除的排程。
- 點選 檢視設定,然後點擊 刪除。
故障排除
關於過期或撤銷的令牌錯誤,請參見 「排程更新失敗,因為 Google 令牌過期或已被撤銷」。
對於排程刷新的其他問題,請刪除 Google Sheets 中的排程以及 Azure Databricks 上對應的 Unity Catalog 連線,然後重新建立排程。 如需進一步瞭解 Unity Catalog 連線,請參閱 管理 Lakehouse Federation 的連線。
排程更新失敗是因為 Google 權杖已過期或遭到撤銷
排程刷新可能會因類似以下錯誤而失敗:
BAD_REQUEST: The OAuth token exchange failed with HTTP status code 400 Bad Request. ... Map(error -> invalid_grant, error_description -> Token has been expired or revoked.)
在連接器側邊欄,執行紀錄顯示: 上次執行失敗,因為 Google 試算表的憑證遺失或過期。從設定連線重新授權連線。
此錯誤表示為排程擁有者儲存的 Google 授權已不再有效。 常見的原因包括:
- 使用者已從 Google 帳號移除連接器的存取權。
- Google Workspace 管理員原則撤銷或限制了該令牌。
- 該授權有六個月未被使用。 請參閱 Google 文件中的 Refresh token 過期 說明。
為了修正錯誤,排程擁有者重新授權 Google 試算表:
- 在 Google 試算表的 Azure Databricks 連接器側欄,點擊 已儲存匯入 標籤。
- 在分頁頂端,點擊刷新圖示右側的排程動作圖示。 然後按一下設定連線。
- 點擊 授權 Google 試算表 並完成 Google 登入。
對話框顯示 Google 試算表授權已啟動。 你現有的排程會在下一次預定執行時恢復。 你不需要重新製作它們。
如果沒有顯示「授權 Google 試算表」,請要求中繼存放區管理員在 Catalog Explorer 的 databricks_google_connection 連線頁面上撤銷你的使用者憑證。 然後重複這些步驟。
局限性
- 你無法編輯排程刷新。 你只能查看或刪除現有的排程。 要修改排程,刪除它並建立新的。
- 如果你編輯了排程所使用的查詢,排程不會自動接收你的變更。 要套用更新後的查詢文字,請刪除排程並重新建立。
- 你無法排程樞紐分析表的重新整理。 Google API 只會更新原始查詢資料,若查詢結果架構改變,無法修改樞紐設定。
- 單一排程最多可包含20個匯入。
- 用於排程刷新的匯入查詢文字有 4,096 個字元限制。