在 Google 試算表中安排資料刷新

本頁說明如何在 Google 試算表的 Databricks 連接器 中排程自動資料刷新,以保持匯入資料的最新狀態。 排程刷新會定期執行你儲存的查詢,並更新相應的工作表。

要求

建立 Unity 目錄連線

排程刷新需要以下事項:

  • 一個名為 databricks_google_connection的 Unity Catalog 連接,由一位在 Google 試算表中負責資料管理的管理員建立。
  • 連線權限 USE CONNECTION ,授予需要建立或管理排程刷新的使用者。
  1. 作為 Azure Databricks 資料目錄管理員,在 Google Sheets 中開啟 Databricks 連接器的側邊欄。
  2. 點選 「已儲存匯入」 標籤。
  3. 點擊右上角的行事曆。
  4. 點擊 設定連線。

在Azure Databricks分享連線

連線建立後,將 USE CONNECTION 特權授予需要建立或管理排程刷新的使用者。 元資料庫管理員或任何具有 MANAGE 連線權限的使用者都可以授予此權限。 欲了解更多連線管理資訊,請參閱「Manage connections for Lakehouse Federation」。

建立排程

每個匯入只能分配到一個排程。 要為現有匯入建立新的排程:

  1. 在 Google 試算表的 Azure Databricks 連接器側欄,點擊 已儲存匯入 標籤。

  2. 點擊行事曆圖示,點選 新行程。

  3. 選擇匯入來建立排程。

  4. 輸入排程的名稱。

  5. 選擇您的行程 頻率 :

    • 若選擇 每小時,請選取要在每小時的第幾分鐘執行重新整理。
    • 對於 每日,請選擇執行刷新的時間。
    • 每週,選擇星期幾及運行刷新的時間。

    排班表會使用你當地的時區。

  6. 選擇用於排程查詢的 SQL 倉庫。

  7. 點擊 建立排程。

查看運行歷史與賽程詳情

要查看所有排程刷新的運行歷史,請執行以下操作:

  1. 在 Google 試算表的 Azure Databricks 連接器側欄,點擊 已儲存匯入 標籤。
  2. 點選行事曆圖示,再點 選「查看跑步紀錄」。
  3. 點擊特定跑步路線以查看賽程詳情。

要查看排程刷新的執行歷史與設定細節,請執行以下步驟:

  1. 在 「檢視運行歷史 」窗格中,選擇你想查看的排程名稱。 在 最近運行中,會顯示每次運行的狀態。

  2. 將滑鼠移到狀態圖示上可查看跑道 的跑道ID、 開始時間和 跑道狀態。

    在「最近跑」中將滑鼠移到狀態圖示上,可查看各跑數詳情

  3. 點擊 「檢視設定 」以查看排程細節,其中包含所選匯入與排程設定。

    • 如果你正在觀看別人建立的行程表,顯示的時間就是創作者當地時區的時間。

刪除排程刷新

要刪除排程刷新,請執行以下步驟:

  1. 在 Google 試算表的 Azure Databricks 連接器側欄,點擊 已儲存匯入 標籤。
  2. 點擊行事曆圖示,然後點 選「管理行程」。
  3. 選擇你想刪除的排程。
  4. 點選 檢視設定,然後點擊 刪除。

故障排除

關於過期或撤銷的令牌錯誤,請參見 「排程更新失敗,因為 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 試算表:

  1. 在 Google 試算表的 Azure Databricks 連接器側欄,點擊 已儲存匯入 標籤。
  2. 在分頁頂端,點擊刷新圖示右側的排程動作圖示。 然後按一下設定連線。
  3. 點擊 授權 Google 試算表 並完成 Google 登入。

對話框顯示 Google 試算表授權已啟動。 你現有的排程會在下一次預定執行時恢復。 你不需要重新製作它們。

如果沒有顯示「授權 Google 試算表」,請要求中繼存放區管理員在 Catalog Explorer 的 databricks_google_connection 連線頁面上撤銷你的使用者憑證。 然後重複這些步驟。

局限性

  • 你無法編輯排程刷新。 你只能查看或刪除現有的排程。 要修改排程,刪除它並建立新的。
  • 如果你編輯了排程所使用的查詢,排程不會自動接收你的變更。 要套用更新後的查詢文字,請刪除排程並重新建立。
  • 你無法排程樞紐分析表的重新整理。 Google API 只會更新原始查詢資料,若查詢結果架構改變,無法修改樞紐設定。
  • 單一排程最多可包含20個匯入。
  • 用於排程刷新的匯入查詢文字有 4,096 個字元限制。