Restaurer des ensembles de données supprimés

Ce document explique comment restaurer (ou annuler la suppression) d'un ensemble de données supprimé dans BigQuery.

Vous pouvez restaurer un ensemble de données pour le récupérer dans l'état où il se trouvait au moment 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 en savoir plus sur la restauration d'une table ou d'un instantané supprimé, consultez les ressources suivantes :

Limites

Voici la 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 des ensembles de données associés ne sont pas restaurées lorsque vous effectuez cette action. Les abonnés doivent s'abonner à nouveau 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.
  • Vous ne pouvez pas restaurer directement une vue logique. Toutefois, vous pouvez annuler la suppression de l'ensemble de données ou recréer la vue pour restaurer votre vue logique. Pour en savoir plus sur ces solutions de contournement, consultez la section Restaurer une vue.
  • Une table BigQuery compatible avec la CDC ne reprend pas les jobs d'application en arrière-plan lorsqu'elle est restaurée dans le cadre d'un ensemble de données dont la suppression a été annulée.

  • L'affichage d'un ensemble de données restauré dans les résultats de recherche BigQuery peut prendre jusqu'à 24 heures.

    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. Par conséquent, si vous restaurez un ensemble de données avec une ressource autorisée moins de 24 heures après sa suppression, il est possible qu'une réautorisation ne soit pas nécessaire. Nous vous recommandons de toujours vérifier l'autorisation après avoir restauré des ressources.

  • Une fois la suppression d'un ensemble de données annulée, il ne peut pas être supprimé dans les sept jours suivants. Les entités des ensembles de données, telles que les tables et les routines, peuvent être supprimées. Si vous avez besoin d'une période plus courte, contactez Google Cloud l'assistance.

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 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 Google Cloud console, 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. Pour spécifier la partie de l'instruction SQL correspondant à l'emplacement, utilisez les options location. 

    UNDROP SCHEMA DATASET_ID OPTIONS (location=location);

  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 datasets.undelete méthode.

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