Ver metadados do snapshot da tabela

Neste documento, descrevemos como visualizar os metadados de um snapshot tabela do BigQuery no console Google Cloud consultando a visualização TABLE_SNAPSHOTS da tabela INFORMATION_SCHEMA, usando o comando bq show ou chamando a API tables.get. Ele se destina a usuários que já conhecem tabelas e snapshots de tabelas do BigQuery.

Permissões e papéis

Nesta seção, descrevemos a permissão de gerenciamento de identidade e acesso (IAM, na sigla em inglês) necessária para visualizar os metadados de um snapshot da tabela e os papéis predefinidos do IAM que concedem essas permissões.

Permissões

Para visualizar os metadados de um snapshot da tabela, você precisa da seguinte permissão:

Permissão	Recurso
bigquery.tables.get	O snapshot 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.metadataViewer bigquery.dataViewer bigquery.dataEditor bigquery.dataOwner bigquery.admin	O snapshot da tabela

Receber os metadados de um snapshot de tabela

Os metadados de um snapshot de tabela são semelhantes aos de uma tabela padrão, com as seguintes diferenças:

• Um outro campo baseTableReference identifica a tabela base de origem do snapshot.
• O campo type tem o valor SNAPSHOT.

É possível visualizar os metadados de um snapshot da tabela usando uma das seguintes opções:

Console

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

   Acessar o BigQuery

2. No painel à esquerda, clique em Explorer:

   

   Se o painel esquerdo não aparecer, clique em Expandir painel esquerdo para abrir.

3. No painel Explorer, expanda seu projeto, clique em Conjuntos de dados e clique no conjunto de dados que tem o snapshot da tabela.

4. Clique em Visão geral > Tabelas e, em seguida, no nome do snapshot da tabela.

5. No painel de snapshot exibido, faça o seguinte:

   • Clique na guia Esquema para visualizar as tags de esquema e de políticas do snapshot da tabela.

   • Clique na tabela Detalhes para ver o tamanho, a validade, a tabela base, o horário do snapshot e outras informações do snapshot da tabela.

SQL

Para ver os metadados de um snapshot da tabela, consulte a visualização INFORMATION_SCHEMA.TABLE_SNAPSHOTS:

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

   Acessar o BigQuery

2. No editor de consultas, digite a seguinte instrução:

   SELECT
     *
   FROM
     PROJECT_ID.DATASET_NAME.INFORMATION_SCHEMA.TABLE_SNAPSHOTS
   WHERE
     table_name = 'SNAPSHOT_NAME';

   Substitua:

   • PROJECT_ID: o ID do projeto que contém o snapshot
   • DATASET_NAME: o nome do conjunto de dados que contém o snapshot.
   • SNAPSHOT_NAME: o nome do snapshot.

3. Clique em Executar.

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

bq

Digite o seguinte comando no Cloud Shell:

Acesse o Cloud Shell

bq show \
--format=prettyjson \
PROJECT_ID:DATASET_NAME.SNAPSHOT_NAME

Substitua:

• PROJECT_ID: o ID do projeto que contém o snapshot
• DATASET_NAME: o nome do conjunto de dados que contém o snapshot.
• SNAPSHOT_NAME: o nome do snapshot.

O resultado será assim:

{
  "creationTime": "1593194331936",
   ...
  "snapshotDefinition": {
    "baseTableReference": {
      "datasetId": "myDataset",
      "projectId": "myProject",
      "tableId": "mytable"
    },
    "snapshotTime": "2020-06-26T17:58:50.815Z"
  },
  "tableReference": {
    "datasetId": "otherDataset",
    "projectId": "myProject",
    "tableId": "mySnapshot"
  },
  "type": "SNAPSHOT"
}

API

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

Parâmetro	Valor
projectId	O ID do projeto que contém o snapshot.
datasetId	O nome do conjunto de dados que contém o snapshot.
tableId	O nome do snapshot.

O corpo da resposta é semelhante a:

{
  "kind": "bigquery#table",
  "etag": "...",
  "id": "myProject:myDataset.mySnapshot",
  "selfLink": "https://content-bigquery.googleapis.com/bigquery/v2/projects/myProject/datasets/myDataset/tables/mySnapshot",
  "tableReference": {
    "projectId": "myProject",
    "datasetId": "myDataset",
    "tableId": "mySnapshot"
  },
  "description": "...",
  "schema": {
    "fields": [
      ...
    ]
  },
  "numBytes": "637931",
  "numLongTermBytes": "0",
  "numRows": "33266",
  "creationTime": "1593194331936",
  "lastModifiedTime": "1593194331936",
  "type": "SNAPSHOT",
  "location": "US",
  "snapshotDefinition": {
    "baseTableReference": {
      "projectId": "myProject",
      "datasetId": "otherDataset",
      "tableId": "myTable"
    },
    "snapshotTime": "2020-06-26T17:58:50.815Z"
  }
}

A seguir

• atualizar a descrição, a data de validade ou a política de acesso de um snapshot da tabela;
• Excluir um snapshot da tabela.