TABLE_SNAPSHOTS 檢視畫面

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

所需權限

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

如要進一步瞭解 BigQuery 權限,請參閱「使用身分與存取權管理功能控管存取權」。

結構定義

查詢 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 建立資料表快照的時間

範圍和語法

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

檢視表名稱 資源範圍 區域範圍
[`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 |
+----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+