Vista TABLE_SNAPSHOTS
A vista INFORMATION_SCHEMA.TABLE_SNAPSHOTS contém metadados sobre as suas
imagens instantâneas de tabelas. Para mais informações, consulte o artigo Introdução às capturas instantâneas de tabelas.
Autorizações necessárias
Para consultar a vista INFORMATION_SCHEMA.TABLE_SNAPSHOTS, precisa da autorização de gestão de identidade e de acesso (IAM) bigquery.tables.list para o conjunto de dados.
A função predefinida roles/bigquery.metadataViewer inclui a autorização
necessária.
Para mais informações sobre as autorizações do BigQuery, consulte o artigo Controlo de acesso com a IAM.
Esquema
Quando consulta a tabela INFORMATION_SCHEMA.TABLE_SNAPSHOTS, os resultados contêm uma linha para cada instantâneo da tabela no conjunto de dados ou na região especificada.
A tabela INFORMATION_SCHEMA.TABLE_SNAPSHOTS tem o seguinte esquema.
A tabela padrão a partir da qual foi tirada a captura instantânea da tabela é denominada tabela base.
| Nome da coluna | Tipo de dados | Valor |
|---|---|---|
table_catalog |
STRING |
O nome do projeto que contém a cópia instantânea da tabela |
table_schema |
STRING |
O nome do conjunto de dados que contém o instantâneo da tabela |
table_name |
STRING |
O nome do instantâneo 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 instantâneo da tabela foi criado |
Âmbito e sintaxe
As consultas desta vista têm de incluir um conjunto de dados ou um qualificador de região. Para consultas com um qualificador de conjunto de dados, tem de ter autorizações para o conjunto de dados. Para consultas com um qualificador de região, tem de ter autorizações para o projeto. Para mais informações, consulte a secção Sintaxe. A tabela seguinte explica os âmbitos da região e dos recursos para esta vista:
| Nome da visualização de propriedade | Âmbito do recurso | Âmbito 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 | Localização do conjunto de dados |
-
Opcional:
PROJECT_ID: o ID do seu projeto do Google Cloud Google Cloud. Se não for especificado, é usado o projeto predefinido. -
REGION: qualquer nome da região do conjunto de dados. Por exemplo,`region-us`. -
DATASET_ID: o ID do seu conjunto de dados. Para mais informações, consulte o artigo 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 seguinte obtém metadados para as capturas instantâneas de tabelas no conjunto de dados mydataset
Neste exemplo, é apresentada a imagem instantânea da tabela myproject.mydataset.mytablesnapshot, que foi tirada da tabela base myproject.mydataset.mytable a 14 de maio de 2021 às 12:00 UTC.
SELECT * FROM `myproject`.mydataset.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;
O resultado é 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 | +----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+