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。如果未指定，则使用默认项目。

    示例

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