還原已刪除的資料集

預先發布版

這項功能 適用《服務專屬條款》。 正式發布前的功能是按照「原樣」提供，支援範圍可能有限。 詳情請參閱推出階段說明。

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

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

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

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

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

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

限制

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

• 還原的資料集可能會參照已不存在的安全主體。
• 執行這項操作時，系統不會還原連結資料集中已刪除資料集的參照。訂閱者必須重新訂閱，才能手動還原連結。
• 執行這項操作時，系統不會還原商家標記。
• 您必須手動重新整理具體化檢視表，並重新授權已授權的檢視表、已授權的資料集和已授權的常式。
• 您無法直接還原邏輯檢視區塊。不過，您可以取消刪除資料集或重新建立檢視區塊，以還原邏輯檢視區塊。如要進一步瞭解這些解決方法，請參閱「還原檢視畫面」。
• 如果已啟用 BigQuery CDC 的資料表是透過還原未刪除的資料集復原，系統不會繼續執行背景套用作業。

• 還原的資料集最多可能需要 24 小時，才會顯示在 BigQuery 搜尋結果中。

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

• 資料集取消刪除後，七天內無法刪除。 您可以刪除資料集的實體，例如資料表和常式。如需較短的期限，請與Google Cloud 支援團隊聯絡。

事前準備

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

必要的角色

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

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

所需權限

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

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

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

還原資料集

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

SQL

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

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

   前往「BigQuery」

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

   UNDROP SCHEMA DATASET_ID;

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

3. 指定要取消刪除的資料集位置。如要指定 SQL 陳述式的位置部分，請使用 location 選項

   UNDROP SCHEMA DATASET_ID OPTIONS (location=location);

4. 按一下 「執行」。

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

API

呼叫 datasets.undelete 方法。

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

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

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

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

  後續步驟

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

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

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