Visualização TABLE_SNAPSHOTS

A visualização INFORMATION_SCHEMA.TABLE_SNAPSHOTS contém metadados sobre os snapshots de tabelas. Para mais informações, consulte Introdução aos snapshots da tabela.

Permissões necessárias

Para consultar a visualização INFORMATION_SCHEMA.TABLE_SNAPSHOTS, é preciso ter a permissão bigquery.tables.list Identity and Access Management (IAM) para o conjunto de dados. O papel predefinido roles/bigquery.metadataViewer inclui a permissão necessária.

Para mais informações sobre as permissões do BigQuery, consulte Controle de acesso com o IAM.

Esquema

Os resultados das consultas na tabela INFORMATION_SCHEMA.TABLE_SNAPSHOTS contêm uma linha para cada snapshot da tabela no conjunto de dados ou região especificado.

A tabela INFORMATION_SCHEMA.TABLE_SNAPSHOTS tem o seguinte esquema. A tabela padrão de origem do snapshot da tabela é chamada de tabela base.

Nome da coluna Tipo de dados Valor
table_catalog STRING Nome do projeto que contém o snapshot da tabela
table_schema STRING O nome do conjunto de dados que contém o snapshot da tabela.
table_name STRING O nome do snapshot da tabela
base_table_catalog STRING O nome do projeto que contém a tabela base
base_table_schema STRING O nome do conjunto de dados que contém a tabela base
base_table_name STRING O nome da tabela base
snapshot_time TIMESTAMP A hora em que o snapshot da tabela foi criado

Escopo e sintaxe

As consultas nessa visualização precisam incluir um conjunto de dados ou um qualificador de região. Para consultas com um qualificador de conjunto de dados, é preciso ter permissões para o conjunto de dados. Para consultas com um qualificador de região, é preciso ter permissões para o projeto. Para mais informações, consulte Sintaxe. A tabela a seguir explica os escopos de região e recurso dessa visualização:

Nome da visualização Escopo do recurso Escopo da região
[`PROJECT_ID`.]`region-REGION`.INFORMATION_SCHEMA.TABLE_SNAPSHOTS Nível do projeto REGION
[`PROJECT_ID`.]DATASET_ID.INFORMATION_SCHEMA.TABLE_SNAPSHOTS Nível do conjunto de dados Local do conjunto de dados
Substitua:

  • Opcional: PROJECT_ID: o ID do seu projeto do Google Cloud. Se não for especificado, o projeto padrão será usado.
: + REGION: qualquer nome da região do conjunto de dados. Por exemplo, region-us. + DATASET_ID: ID do conjunto de dados. Para mais informações, consulte Qualificador de conjunto de dados.

Exemplo

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

Exemplo

A consulta a seguir recupera metadados dos snapshots da tabela no conjunto de dados mydataset. Neste exemplo, ele exibe o snapshot da tabela myproject.mydataset.mytablesnapshot, que foi retirado da tabela base myproject.mydataset.mytable em 14 de maio de 2021, às 12h UTC.

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

O resultado será semelhante ao seguinte:

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