Restaurer des ensembles de données supprimés

Ce document explique comment restaurer (ou récupérer) un ensemble de données supprimé dans BigQuery.

Vous pouvez restaurer un ensemble de données pour le récupérer à l'état dans lequel il se trouvait lors de sa suppression. Vous ne pouvez restaurer que les ensembles de données situés dans votre fenêtre de fonctionnalité temporelle. Cette récupération inclut tous les objets qu'il contenait ainsi que leurs propriétés et les paramètres de sécurité. Pour connaître les ressources non récupérées, consultez la section Limites.

Pour savoir comment restaurer une table ou un instantané supprimé, consultez les ressources suivantes :

Limites

Voici une liste des limites liées à la restauration d'un ensemble de données :

  • Les ensembles de données restaurés peuvent faire référence à des comptes principaux de sécurité qui n'existent plus.
  • Les références à un ensemble de données supprimé dans les ensembles de données associés ne sont pas restaurées lorsque vous effectuez cette action. Les abonnés doivent se réabonner pour restaurer manuellement les liens.
  • Les tags d'entreprise ne sont pas restaurés lorsque vous effectuez cette action.
  • Vous devez actualiser manuellement les vues matérialisées et réautoriser les vues autorisées, les ensembles de données autorisés et les routines autorisées.

  • Une table compatible avec la CDC BigQuery ne reprend pas les jobs d'application en arrière-plan lorsqu'elle est restaurée dans un ensemble de données qui n'a pas été supprimé.

    Lorsque des ressources autorisées (vues, ensembles de données et routines) sont supprimées, la suppression de l'autorisation peut prendre jusqu'à 24 heures. Ainsi, si vous restaurez un ensemble de données avec une ressource autorisée moins de 24 heures après la suppression, il est possible que cette nouvelle autorisation ne soit pas nécessaire. Il est recommandé de toujours vérifier l'autorisation après la restauration des ressources.

Avant de commencer

Assurez-vous de disposer des autorisations IAM (Identity and Access Management) nécessaires pour restaurer un ensemble de données supprimé.

Rôles requis

Pour obtenir les autorisations nécessaires pour restaurer un ensemble de données supprimé, demandez à votre administrateur de vous accorder le rôle IAM Utilisateur BigQuery (roles/bigquery.user) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient les autorisations requises pour restaurer un ensemble de données supprimé. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour restaurer un ensemble de données supprimé :

  • bigquery.datasets.create sur le projet
  • bigquery.datasets.get sur l'ensemble de données

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Restaurer un ensemble de données

Pour restaurer un ensemble de données, sélectionnez l'une des options suivantes :

SQL

Utilisez l'instruction LDD (langage de définition de données) UNDROP SCHEMA :

  1. Dans la console Google Cloud , accédez à la page BigQuery.

    Accéder à BigQuery

  2. Dans l'éditeur de requête, saisissez l'instruction suivante :

    UNDROP SCHEMA DATASET_ID;

    Remplacez DATASET_ID par l'ensemble de données dont vous souhaitez annuler la suppression.

  3. Spécifiez l'emplacement de l'ensemble de données dont vous souhaitez annuler la suppression.

  4. Cliquez sur Exécuter.

Pour en savoir plus sur l'exécution des requêtes, consultez Exécuter une requête interactive.

API

Appelez la méthode datasets.undelete.

Lorsque vous restaurez un ensemble de données, les erreurs suivantes peuvent se produire :

  • ALREADY_EXISTS : un ensemble de données portant le même nom existe déjà dans la région dans laquelle vous avez tenté de restaurer. Vous ne pouvez pas utiliser l'annulation de suppression pour écraser ou fusionner des ensembles de données.
  • NOT_FOUND : l'ensemble de données que vous essayez de récupérer a dépassé sa fenêtre de fonctionnalité temporelle, n'a jamais existé ou vous n'avez pas spécifié le bon emplacement de l'ensemble de données.

  • ACCESS_DENIED : vous ne disposez pas des autorisations requises pour annuler la suppression de cet ensemble de données.

    Étapes suivantes

  • Pour savoir comment interroger des données à un moment précis, consultez Accéder aux données de l'historique.

  • Pour en savoir plus sur la conservation des données, consultez Conservation des données avec la fonctionnalité temporelle et de sécurité.

  • Pour savoir comment supprimer un ensemble de données, consultez Gérer les ensembles de données.