Restaurar conjuntos de dados excluídos

Este documento descreve como restaurar (ou cancelar a exclusão) um conjunto de dados excluído no BigQuery.

É possível restaurar um conjunto de dados para recuperá-lo para o estado em que ele estava quando foi excluído. Só é possível restaurar conjuntos de dados que estão dentro da janela de viagem no tempo. Essa recuperação inclui todos os objetos contidos no conjunto de dados, as propriedades dele e as configurações de segurança. Para recursos que não são recuperados, consulte Limitações.

Para mais informações sobre como restaurar uma tabela ou um snapshot excluído, consulte os seguintes recursos:

Limitações

Confira a seguir uma lista de limitações relacionadas �� restauração de um conjunto de dados:

  • Os conjuntos de dados restaurados podem fazer referência a principais de segurança que não existem mais.
  • As referências a um conjunto de dados excluído em conjuntos de dados vinculados não são restauradas quando você realiza essa ação. Os assinantes precisam se inscrever de novo para restaurar os links manualmente.
  • As tags de empresas não são restauradas quando você realiza essa ação.
  • É necessário atualizar manualmente as visualizações materializadas e autorizar novamente visualizações autorizadas, conjuntos de dados autorizados e rotinas autorizadas.

  • Uma tabela ativada pelo CDC do BigQuery não retoma jobs de aplicação em segundo plano quando restaurada como parte de um conjunto de dados não excluído.

    Quando recursos autorizados (visualizações, conjuntos de dados e rotinas) são excluídos, a autorização leva até 24 horas para ser excluída. Portanto, se você restaurar um conjunto de dados com um recurso autorizado menos de 24 horas após a exclusão, talvez não seja necessária uma nova autorização. Como prática recomendada, sempre verifique a autorização depois de restaurar recursos.

Antes de começar

Verifique se você tem as permissões necessárias do Identity and Access Management (IAM) para restaurar um conjunto de dados excluído.

Funções exigidas

Para receber as permissões necessárias para restaurar um conjunto de dados excluído, 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.

Esse papel predefinido contém as permissões necessárias para restaurar um conjunto de dados excluído. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para restaurar um conjunto de dados excluído:

  • bigquery.datasets.create no projeto
  • bigquery.datasets.get no conjunto de dados

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Restaurar um conjunto de dados

Para restaurar um conjunto de dados, selecione uma das seguintes opções:

SQL

Use a instrução de linguagem de definição de dados (DDL) UNDROP SCHEMA:

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

    Acessar o BigQuery

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

    UNDROP SCHEMA DATASET_ID;

    Substitua DATASET_ID pelo conjunto de dados que você quer cancelar a exclusão.

  3. Especifique o local do conjunto de dados que você quer cancelar a exclusão.

  4. Clique em Executar.

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

API

Chame o método datasets.undelete.

Ao restaurar um conjunto de dados, os seguintes erros podem ocorrer:

  • ALREADY_EXISTS: um conjunto de dados com o mesmo nome já existe na região em que você tentou restaurar. Não é possível usar o cancelamento da exclusão para substituir ou mesclar conjuntos de dados.
  • NOT_FOUND: o conjunto de dados que você está tentando recuperar passou da janela de viagem no tempo, nunca existiu ou você não especificou o local correto do conjunto de dados.

  • ACCESS_DENIED: você não tem as permissões necessárias para cancelar a exclusão deste conjunto de dados.

    A seguir

  • Para informações sobre como consultar dados em um determinado momento, consulte Acessar dados históricos.

  • Para informações sobre a retenção de dados, consulte Retenção de dados com viagem no tempo e segurança contra falhas.

  • Para saber como excluir um conjunto de dados, consulte Gerenciar conjuntos de dados.