Excluir snapshots da tabela

Neste documento, descrevemos como excluir um snapshot de tabela usando o console do Google Cloud, uma DROP SNAPSHOT TABLE instrução do GoogleSQL, um comando bq rm ou uma chamada tables.delete da API BigQuery. Ele também fornece informações sobre como recuperar um snapshot de tabela que foi excluído ou que expirou nos últimos sete dias. Ele é destinado a usuários familiarizados com os snapshots da tabela.

Permissões e papéis

Esta seção descreve asPermissão de gerenciamento de identidade e acesso (IAM, na sigla em inglês) que você precisa excluir um snapshot da tabela, e opapéis predefinidos do IAM que concede essas permissões.

Permissões

Para excluir um snapshot de tabela, você precisa da seguinte permissão:

Permissão Recurso
bigquery.tables.deleteSnapshot O snapshot da tabela que você quer excluir.

Papéis

Os papéis predefinidos do BigQuery que fornecem as permissões necessárias são os seguintes:

Papel Recurso
Qualquer um dos seguintes:

bigquery.dataOwner
bigquery.admin
O snapshot da tabela que você quer excluir.

Excluir um snapshot da tabela

Exclua um snapshot da tabela como excluiria uma tabela padrão. Não é necessário excluir um snapshot de tabela que expirou.

É possível excluir um snapshot da tabela usando uma das seguintes opções:

Console

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

Ir para o BigQuery

  1. No painel Explorer, expanda os nós do projeto e do conjunto de dados do snapshot da tabela que você quer ver.

  2. Clique no nome do snapshot da tabela.

  3. No painel do snapshot exibido, clique em Excluir.

  4. Confirme e clique em Excluir novamente.

SQL

Use a instrução DDL DROP SNAPSHOT TABLE:

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

    Ir para o BigQuery

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

    DROP SNAPSHOT TABLE 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.

  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 rm \
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.

API

Chame o método tables.delete 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.

Restaurar um snapshot de tabela excluído ou expirado

É possível recuperar um snapshot de tabela que foi excluído ou que expirou nos últimos sete dias da mesma forma que você recupera uma tabela padrão. Para mais informações, consulte Restaurar tabelas excluídas.

A seguir