Restaurer un service à partir d'une sauvegarde

La restauration vous permet de récupérer les métadonnées et la configuration stockées de votre service Dataproc Metastore à partir d'une sauvegarde.

Cette page explique comment restaurer les métadonnées d'un service Dataproc Metastore.

Contrôle des accès

  • Pour restaurer les métadonnées, vous devez demander un rôle IAM contenant les autorisations IAM metastore.services.restore et metastore.backups.use. Les rôles roles/metastore.admin et roles/metastore.editor propres à Dataproc Metastore incluent des autorisations de restauration.

  • Vous pouvez accorder une autorisation de restauration à des utilisateurs ou à des groupes à l'aide des anciens rôles roles/owner et roles/editor.

Pour en savoir plus, consultez la page IAM et contrôle des accès Dataproc Metastore.

Restaurer un service à partir d'une sauvegarde

Pour restaurer un service à partir d'une sauvegarde, choisissez une sauvegarde sur la page "Informations sur le service" ouverte dans un navigateur local, utilisez l'outil gcloud ou émettez une méthode d'API Dataproc Metastoreservices.restore.

Vous pouvez restaurer les métadonnées avec la configuration de service actuelle ou restaurer les métadonnées avec la configuration de service de sauvegarde. Vous pouvez restaurer la configuration du service de sauvegarde et des métadonnées en même temps. La configuration inclut des paramètres tels que le réseau, le port et le niveau de service, qui sont les mêmes que vous pouvez modifier à l'aide de la méthode API service.update.

Vous ne pouvez pas mettre à jour le service tant qu'une restauration est en attente. Vous pouvez continuer à utiliser le service lorsqu'une restauration est en cours.

Pour restaurer un service Dataproc Metastore à partir d'une sauvegarde, procédez comme suit:

Console

  1. Dans Cloud Console, ouvrez la page "Dataproc Metastore" :

    Ouvrir Dataproc Metastore dans Cloud Console

  2. Sur la page Dataproc Metastore, cliquez sur le nom du service dans lequel vous souhaitez restaurer les métadonnées. La page Service detail (Informations sur le service) s'affiche.

    Page d'information sur le service
  3. Cliquez sur l'onglet Sauvegarder/Restaurer pour afficher les sauvegardes du service.

  4. À droite de la sauvegarde que vous souhaitez utiliser, cliquez sur et sélectionnez Restaurer. La page de restauration s'affiche.

    Vous pouvez également restaurer votre service sur la page "Détails de la sauvegarde" en cliquant sur le nom de la sauvegarde que vous souhaitez utiliser, puis sur Restaurer.

  5. Sélectionnez une option de restauration:

    • Restaurer les données du métastore

      Restaure uniquement le contenu de données stocké dans la sauvegarde.

    • Restaurer les données de métastore et la configuration du service

      Restaure le contenu des données stocké dans la sauvegarde et applique la configuration de service stockée dans la sauvegarde au service actuel.

  6. Cliquez sur Restaurer pour mettre à jour le service.

  7. Vérifiez que vous êtes revenu sur la page Informations sur le service et que votre restauration apparaît sous Historique de restauration sur la page Sauvegarde/Restauration.

gcloud

  1. Exécutez la commande gcloud metastore services restore suivante pour restaurer les métadonnées dans un service:

    gcloud metastore services restore SERVICE  \
        --location=LOCATION \
        --backup=BACKUP \
        --restore-type=RESTORE_TYPE
        --project=PROJECT_ID
    

    Remplacez les éléments suivants :

    • SERVICE : nom du service.
    • LOCATION: emplacement du service.
    • BACKUP: fait référence à la ressource de sauvegarde à partir de laquelle effectuer la restauration. Il peut s'agir de l'ID de la sauvegarde, de l'URL complète ou du nom relatif.
    • RESTORE_TYPE: type de restauration à effectuer. La valeur par défaut est metadata-only.
    • PROJECT_ID: projet du service.
  2. Vérifiez que la restauration a réussi.

REST

Suivez les instructions de l'API pour restaurer des métadonnées dans un service à l'aide de l'explorateur d'API.

Une fois la restauration réussie, le service passe automatiquement à l'état Actif. En cas d'échec, le service revient à son état opérationnel précédent.

Pour afficher l'historique de restauration d'un service, reportez-vous à l'onglet Sauvegarder/Restaurer de la page Informations sur le service de Cloud Console.

Mises en garde concernant la restauration

  • Les libellés de service Dataproc Metastore et les données réelles du répertoire datastore ne sont pas restaurés.

  • Vous ne pouvez restaurer des métadonnées qu'à partir de sauvegardes créées à partir de services Dataproc Metastore dans le même projet et la même région que le service cible.

    • Vous pouvez restaurer les métadonnées à partir d'une sauvegarde interservices à l'aide de l'outil de ligne de commande gcloud ou de la méthode API REST.
  • L'historique des restaurations précédentes est disponible dans l'interface utilisateur. La suppression du service entraîne la suppression de tout l'historique de restauration associé à ce service.

Échecs courants

  • L'utilisateur qui restaure le service Dataproc Metastore à partir d'une sauvegarde ne dispose pas des autorisations metastore.services.restore et metastore.backups.use.

Étape suivante