Restaurer un service à partir d'une sauvegarde

La restauration vous permet de récupérer les métadonnées stockées et la configuration du 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 disposer d'un rôle IAM contenant les autorisations IAM metastore.services.restore et metastore.backups.use. Les rôles spécifiques de Dataproc Metastore roles/metastore.admin et roles/metastore.editor incluent une autorisation 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 "Détails du service" ouverte dans un navigateur local, utilisez l'élémentgcloud ou envoyer une méthode API Dataproc Metastoreservices.restore (Installation de Python groupée).

Vous avez la possibilité de restaurer les métadonnées avec la configuration de service actuelle ou avec les configurations de service de sauvegarde. Vous pouvez restaurer la configuration des métadonnées et du service de sauvegarde simultanément. 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 pendant qu'une restauration est en attente. Vous pouvez continuer à utiliser le service pendant une opération de restauration.

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 Détails du service s'ouvre.

    Page d'information sur le service
  3. Cliquez sur l'onglet Sauvegardes/Restaurations 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'ouvre.

    Vous pouvez également restaurer votre service sur la page "Informations sur 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 des données stockées dans la sauvegarde.

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

      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 s'affiche dans l'historique de restauration de 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: l'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 d'un 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 bien été effectuée.

REST

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

Une fois la restauration terminée, 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, consultez l'onglet Sauvegardes/Restaurations sur la page Informations sur le service de Cloud Console.

Restaurer les mises en garde

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

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

    • Vous pouvez utiliser l'outil de ligne de commande gcloud ou la méthode API REST pour restaurer des métadonnées à partir d'une sauvegarde interservices.
  • 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 sous 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