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 | +----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+