還原已刪除的資料集

預先發布版

這項功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。 正式發布前的功能是依「原樣」提供，支援服務可能受限。 詳情請參閱「推出階段說明」。

注意： 如要提供意見回饋或詢問與這個預先發布版本相關的問題，請傳送電子郵件至 [e-mail]。

本文說明如何在 BigQuery 中還原 (或取消刪除) 已刪除的資料集。

您可以還原資料集，將其復原到刪除時的狀態。您只能還原時間回溯期內的資料集。這項復原作業會還原資料集中的所有物件、資料集屬性和安全性設定。如要瞭解無法復原的資源，請參閱「限制」一節。

注意： 您只能還原特定資料集 ID 的最新資料集。如果您刪除資料集，然後建立 ID 相同的新資料集，就無法還原原始資料集。不過，您或許還是可以從已刪除的資料集還原特定資料表。

如要瞭解如何還原已刪除的資料表或快照，請參閱下列資源：

• 還原已刪除的資料表
• 還原資料表快照

限制

以下是還原資料集的相關限制：

• 還原的資料集可能參照已不存在的安全主體。
• 執行這項操作時，系統不會還原連結資料集中已刪除資料集的參照。訂閱者必須重新訂閱，才能手動還原連結。
• 執行這項操作時，系統不會還原商家標記。
• 您必須手動重新整理具體化檢視表，並重新授權已授權檢視表、已授權資料集和已授權常式。

• 如果還原的資料集包含 BigQuery 啟用 CDC 的資料表，系統不會繼續執行背景套用作業。

  刪除授權資源 (檢視表、資料集和常式) 時，授權最多需要 24 小時才會刪除。因此，如果您在刪除授權資源後 24 小時內還原資料集，可能不需要重新授權。最佳做法是還原資源後，一律驗證授權。

事前準備

確認您具備必要的 Identity and Access Management (IAM) 權限，可還原已刪除的資料集。

必要的角色

如要取得還原已刪除資料集所需的權限，請要求管理員授予您專案的 BigQuery 使用者 (roles/bigquery.user) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

這個預先定義的角色具備還原已刪除資料集所需的權限。如要查看確切的必要權限，請展開「必要權限」部分：

所需權限

如要還原已刪除的資料集，必須具備下列權限：

• 專案的 bigquery.datasets.create
• bigquery.datasets.get 資料集

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

還原資料集

如要還原資料集，請選取下列其中一個選項：

SQL

使用UNDROP SCHEMA資料定義語言 (DDL) 陳述式：

1. 前往 Google Cloud 控制台的「BigQuery」頁面。

   前往 BigQuery

2. 在查詢編輯器中輸入下列陳述式：

   UNDROP SCHEMA DATASET_ID;

   將 DATASET_ID 替換為要取消刪除的資料集。

3. 指定要取消刪除的資料集位置。

4. 按一下「執行」。

如要進一步瞭解如何執行查詢，請參閱「執行互動式查詢」。

API

呼叫 datasets.undelete 方法。

注意： 如果專案中有兩個已刪除的資料集，且這兩個資料集在不同區域中具有相同名稱，則使用 BigQuery API 還原資料集時，系統只會隨機選取並還原其中一個資料集，除非您指定位置。

還原資料集時，可能會發生下列錯誤：

• ALREADY_EXISTS：您嘗試還原的區域中，已有名稱相同的資料集。您無法使用復原功能覆寫或合併資料集。
• NOT_FOUND：您要復原的資料集已超過時間範圍、從未存在，或是您未指定資料集的正確位置。

• ACCESS_DENIED：您沒有必要的權限，無法取消刪除這個資料集。

  後續步驟

• 如要瞭解如何查詢特定時間點的資料，請參閱「存取歷史資料」。

• 如要瞭解資料保留機制，請參閱「資料保留與時間旅行和安全防護」。

• 如要瞭解如何刪除資料集，請參閱「管理資料集」。