TABLE_SNAPSHOTS 檢視畫面

INFORMATION_SCHEMA.TABLE_SNAPSHOTS 檢視畫面包含資料表快照的中繼資料。詳情請參閱「資料表快照簡介」。

所需權限

如要查詢 INFORMATION_SCHEMA.TABLE_SNAPSHOTS 檢視區塊，您需要資料集的 bigquery.tables.list Identity and Access Management (IAM) 權限。roles/bigquery.metadataViewer 預先定義的角色具備必要權限。

如要進一步瞭解 BigQuery 權限，請參閱「使用 IAM 控管存取權」。

結構定義

查詢 INFORMATION_SCHEMA.TABLE_SNAPSHOTS 資料表時，結果會針對指定資料集或區域中的每個資料表快照，分別列出一個相對應的資料列。

INFORMATION_SCHEMA.TABLE_SNAPSHOTS 資料表具有下列結構定義：擷取資料表快照的標準資料表稱為「基本資料表」。

資料欄名稱 資料類型 值
table_catalog STRING 包含資料表快照的專案名稱
table_schema STRING 包含資料表快照的資料集名稱
table_name STRING 資料表快照的名稱
base_table_catalog STRING 包含基礎資料表的專案名稱
base_table_schema STRING 包含基礎資料表的資料集名稱
base_table_name STRING 基本資料表的名稱
snapshot_time TIMESTAMP 建立資料表快照的時間

為確保穩定性，建議您在資訊結構定義查詢中明確列出資料欄，而非使用萬用字元 (SELECT *)。明確列出資料欄可避免基礎結構定義變更時，查詢中斷。

範圍和語法

對這個檢視表執行的查詢必須包含資料集或區域限定詞。如果是含有資料集限定符的查詢，您必須具備該資料集的權限。如要查詢含有區域限定符的資料，您必須具備專案權限。詳情請參閱「語法」。下表說明這個檢視畫面的區域和資源範圍：

檢視表名稱 資源範圍 區域範圍
[`PROJECT_ID`.]`region-REGION`.INFORMATION_SCHEMA.TABLE_SNAPSHOTS 專案層級 REGION
[`PROJECT_ID`.]DATASET_ID.INFORMATION_SCHEMA.TABLE_SNAPSHOTS 資料集層級 資料集位置
取代下列項目：
  • 選用：PROJECT_ID：您的 Google Cloud 專案 ID。如未指定，系統會使用預設專案。
  • REGION：任何資料集區域名稱。 例如：`region-us`。
  • DATASET_ID：資料集 ID。詳情請參閱「資料集限定符」。

示例

-- Returns metadata for the table snapshots in the specified dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;

-- Returns metadata for the table snapshots in the specified region.
SELECT * FROM `region-us`.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;

範例

下列查詢會擷取 mydataset 資料集中的資料表快照中繼資料。在這個範例中，系統會顯示資料表快照 myproject.mydataset.mytablesnapshot，這是 2021 年 5 月 14 日世界標準時間中午 12 點從基本資料表 myproject.mydataset.mytable 擷取的快照。

SELECT *
FROM
  `myproject`.mydataset.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;

結果大致如下：

+----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+
| table_catalog  | table_schema  | table_name      | base_table_catalog | base_table_schema | base_table_name | snapshot_time               |
+----------------+---------------+-----------------+----------------------------------------------------------------------------------------+
| myproject      | mydataset     | mytablesnapshot | myProject          | mydataset         | mytable         | 2021-05-14 12:00:00.000 UTC |
+----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+