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