Esta página foi traduzida pela API Cloud Translation.

Listar snapshots da tabela

Veja neste documento como conseguir uma lista de snapshots de tabelas em um conjunto de dados do BigQuery no Console do Google Cloud, consultando a tabela INFORMATION_SCHEMA.TABLE_SNAPSHOTS, usando o comando bq ls ou chamando a API tables.list. Ele também explica como listar todos os snapshots de uma tabela base específica consultando a tabela INFORMATION_SCHEMA.TABLE_SNAPSHOTS. Este documento se destina a usuários que já conhecem tabelas e snapshots de tabelas do BigQuery.

Permissões e papéis

Nesta seção, descrevemos as permissões do Identity and Access Management (IAM) necessárias para listar os snapshots da tabela em um conjunto de dados e os papéis predefinidos do IAM que concedem essas permissões. As permissões e os papéis para listar snapshots da tabela são os mesmos que as permissões e os papéis necessários para listar outros tipos de tabelas.

Permissões

Para listar os snapshots da tabela em um conjunto de dados, você precisa da seguinte permissão:

Permissão	Recurso
`bigquery.tables.list`	O conjunto de dados que contém os snapshots da tabela.

Papéis

Os papéis predefinidos do BigQuery que fornecem a permissão necessária são os seguintes:

Papel	Recurso
Qualquer um dos seguintes: `bigquery.dataUser` `bigquery.dataViewer` `bigquery.dataEditor` `bigquery.dataOwner` `bigquery.admin`	O conjunto de dados que contém os snapshots da tabela.

Listar os snapshots da tabela em um conjunto de dados

O recebimento de uma lista de snapshots da tabela em um conjunto de dados é semelhante à listagem de outros tipos de tabelas. Os snapshots da tabela têm o tipo SNAPSHOT.

É possível listar os snapshots da tabela usando uma das seguintes opções:

Console

No Console do Google Cloud, acesse a página BigQuery.

Ir para o BigQuery
No painel Explorer, expanda os nós do projeto e do conjunto de dados com os snapshots de tabela que você quer listar.
É possível identificar os snapshots de tabela no conjunto de dados pelo ícone.

SQL

Consulte a visualização INFORMATION_SCHEMA.TABLE_SNAPSHOTS.

No Console do Google Cloud, acesse a página BigQuery.

Ir para o BigQuery
No editor de consultas, digite a seguinte instrução:
```
SELECT
  *
FROM
  PROJECT_ID.DATASET_NAME.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;
```
Substitua:
- PROJECT_ID: o ID do projeto que contém os snapshots que você quer listar.
- DATASET_NAME: o nome do conjunto de dados que contém os snapshots que você quer listar.
Clique em Executar.

Para mais informações sobre como executar consultas, acesse Executar uma consulta interativa.

O resultado será semelhante a este:

+---------------+----------------+------------------+--------------------+-------------------+-----------------+-----------------------------+
| table_catalog | table_schema   | table_name       | base_table_catalog | base_table_schema | base_table_name | snapshot_time               |
+---------------+----------------+------------------+--------------------+-------------------+-----------------+-----------------------------+
| myproject     | mydataset      | mysnapshot       | basetableproject   | basetabledataset           | basetable           | 2021-04-16 14:05:27.519 UTC |
+---------------+----------------+------------------+--------------------+-------------------+-----------------+-----------------------------+

bq

Digite o seguinte comando no Cloud Shell:

Acesse o Cloud Shell

bq ls \
PROJECT_ID:DATASET_NAME

Substitua:

PROJECT_ID: o ID do projeto que contém os snapshots que você quer listar.
DATASET_NAME: o nome do conjunto de dados que contém os snapshots que você quer listar.

A resposta será semelhante a:

+-------------------------+--------+---------------------+-------------------+
|         tableId         |  Type  |       Labels        | Time Partitioning |
+-------------------------+--------+---------------------+-------------------+
| mysnapshot              |SNAPSHOT|                     |                   |
+-------------------------+--------+---------------------+-------------------+

API

Chame o método tables.list com os seguintes parâmetros:

Parâmetro	Valor
`projectId`	O ID do projeto que contém os snapshots que você quer listar.
`datasetId`	O nome do conjunto de dados que contém os snapshots que você quer listar.

Listar os snapshots de uma tabela base especificada

É possível listar os snapshots de uma tabela base especificada consultando a visualização INFORMATION_SCHEMA.TABLE_SNAPSHOTS:

SELECT
  *
FROM
  PROJECT_ID.DATASET_NAME.INFORMATION_SCHEMA.TABLE_SNAPSHOTS
WHERE
  base_table_name = 'books';