Excluir snapshots da tabela

Neste documento, descrevemos como excluir um snapshot de tabela usando o Cloud de Confiance console, uma DROP SNAPSHOT TABLE instrução do GoogleSQL, um bq rm comando, 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 Cloud de Confiance console, acesse a página BigQuery.

Acessar o BigQuery

  1. No painel à esquerda, clique em Explorer:

    Imagem do botão destacado do painel "Explorer".

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

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

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

  4. No painel de detalhes que aparece, clique em Excluir.

  5. Na caixa de diálogo que aparece, digite delete e clique em Excluir novamente.

SQL

Use a instrução DDL DROP SNAPSHOT TABLE:

  1. No Cloud de Confiance console, acesse a página BigQuery.

    Acessar 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 snapshots de tabelas.

A seguir