Restaurar tabelas excluídas
Neste documento, descrevemos como restaurar (ou cancelar a exclusão) de uma tabela excluída no BigQuery. É possível restaurar uma tabela excluída dentro do período de tempo especificado para o conjunto de dados, incluindo exclusões explícitas e implícitas devido à expiração da tabela. Você também pode configurar a janela de viagem no tempo.
Para informações sobre como restaurar um conjunto de dados ou snapshot excluído por completo, consulte os seguintes recursos:
O período de viagem pode ser de dois a sete dias. Depois que a janela de viagem no tempo expira, o BigQuery oferece um período de segurança contra falhas em que os dados excluídos são retidos automaticamente por mais sete dias. Depois que o período de segurança expira, não é possível restaurar uma tabela usando qualquer método, incluindo a abertura de um tíquete de suporte.
Antes de começar
Verifique se você tem as permissões necessárias do Identity and Access Management (IAM) para restaurar uma tabela excluída.
Funções exigidas
Para receber as permissões necessárias
para restaurar uma tabela excluída,
peça ao administrador para conceder a você o
papel do IAM de Usuário do BigQuery (roles/bigquery.user
)
no projeto.
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.
Restaurar uma tabela
Ao restaurar uma tabela de dados históricos, as tags da tabela de origem não são copiadas para a tabela de destino.
É possível restaurar uma tabela que foi excluída, mas ainda está dentro do período de viagem
copiando-a para uma nova tabela usando o decorador de tempo @<time>
.
Não é possível consultar uma tabela excluída, mesmo que você use um decorador de tempo. Primeiro, restaure o dispositivo.
Para restaurar uma tabela, selecione uma das seguintes opções:
Console
Não é possível cancelar a exclusão de uma tabela usando o console Google Cloud .
bq
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Para restaurar uma tabela, primeiro determine um carimbo de data/hora UNIX de quando a tabela existia (em milissegundos). É possível usar o comando
date
do Linux para gerar o carimbo de data/hora Unix a partir de um valor de carimbo de data/hora normal:date -d '2023-08-04 16:00:34.456789Z' +%s000
Em seguida, use o comando
bq copy
com o decorador de viagem no tempo@<time>
para executar a operação de cópia da tabela.Por exemplo, digite o seguinte comando para copiar a tabela
mydataset.mytable
no momento1418864998000
para uma nova tabelamydataset.newtable
.bq cp mydataset.mytable@1418864998000 mydataset.newtable
Opcional: forneça a sinalização
--location
e defina o valor do local.Também é possível especificar um deslocamento relativo. O exemplo a seguir copia a versão de uma tabela de uma hora atrás:
bq cp mydataset.mytable@-3600000 mydataset.newtable
Para mais informações, consulte Restaurar uma tabela de um momento.
Go
Antes de testar esta amostra, siga as instruções de configuração do Go no Guia de início rápido do BigQuery: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API BigQuery em Go.
Para autenticar no BigQuery, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Java
Antes de testar esta amostra, siga as instruções de configuração do Java no Guia de início rápido do BigQuery: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API BigQuery em Java.
Para autenticar no BigQuery, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Node.js
Antes de testar esta amostra, siga as instruções de configuração do Node.js no Guia de início rápido do BigQuery: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API BigQuery em Node.js.
Para autenticar no BigQuery, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Python
Antes de testar esta amostra, siga as instruções de configuração do Python no Guia de início rápido do BigQuery: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API BigQuery em Python.
Para autenticar no BigQuery, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.
Se você antecipar que talvez queira restaurar uma tabela mais tarde diferente da permitida pelo período de viagem, crie um snapshot da tabela. Para mais informações, consulte Introdução aos snapshots da tabela.
A seguir
- Saiba como criar e usar tabelas.
- Saiba como gerenciar tabelas.
- Saiba como modificar esquemas de tabelas.
- Saiba como trabalhar com dados de tabela.