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	表快照的创建时间

范围和语法

针对此视图的查询必须包含数据集或区域限定符。对于包含数据集限定符的查询，您必须拥有数据集的权限。对于包含区域限定符的查询，您必须拥有项目的权限。如需了解详情，请参阅语法。下表说明了此视图的区域和资源范围：

视图名称	资源范围	区域范围
[`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。如需了解详情，请参阅数据集限定符。

注意：您必须指定位置以查询 INFORMATION_SCHEMA 视图，并且查询执行的位置必须与 INFORMATION_SCHEMA 视图的区域相匹配。

示例

-- 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.mytable 截取的表快照 myproject.mydataset.mytablesnapshot，截取时间为世界协调时间 (UTC) 2021 年 5 月 14 日中午 12 点。

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