Restaurer Dataproc Metastore à partir d'une sauvegarde

Cette page explique comment restaurer un service Dataproc Metastore à partir d'une sauvegarde.

Une sauvegarde est un instantané des paramètres de configuration et des métadonnées stockés dans un service Dataproc Metastore. Vous pouvez utiliser la fonctionnalité de restauration pour configurer rapidement un nouveau service Dataproc Metastore à l'aide des données précédemment enregistrées dans une sauvegarde.

Avant de commencer

Activez Dataproc Metastore dans votre projet.
Créez un service Dataproc Metastore.
Sauvegardez un service Dataproc Metastore.

Rôles requis

Pour obtenir l'autorisation dont vous avez besoin pour restaurer un service Dataproc Metastore à partir d'une sauvegarde, demandez à votre administrateur de vous attribuer les rôles IAM suivants sur votre projet, en suivant le principe du moindre privilège:

Accorder un accès complet à toutes les ressources Dataproc Metastore, y compris l'administration des stratégies IAM (roles/metastore.admin)
Accorder un contrôle complet des ressources Dataproc Metastore (roles/metastore.editor)

Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

Ce rôle prédéfini contient l'autorisation metastore.services.restore, metastore.backups.use, qui est requise pour restaurer un service Dataproc Metastore à partir d'une sauvegarde.

Vous pouvez également obtenir cette autorisation à l'aide des rôles personnalisés ou d'autres rôles prédéfinis.

Pour en savoir plus sur les rôles et les autorisations de Dataproc Metastore spécifiques, consultez la présentation IAM de Dataproc Metastore.

À propos de la restauration à partir d'une sauvegarde

Lorsque vous restaurez un service à partir d'une sauvegarde, vous pouvez choisir l'une des options suivantes:

Restaurez toutes les métadonnées et les paramètres de configuration enregistrés dans la sauvegarde.
Restaurez toutes les métadonnées, mais pas les paramètres de configuration enregistrés dans la sauvegarde. Au lieu de cela, votre service conserve vos paramètres de configuration actuels.

Les paramètres de configuration incluent les paramètres Dataproc Metastore, tels que le nom du service, le numéro de port et les paramètres réseau. Métadonnées inclut toutes les informations de base de données et de table stockées dans un service Dataproc Metastore.

Points à prendre en compte

Lorsqu'une opération de restauration est en cours d'exécution, vous ne pouvez pas mettre à jour votre service, par exemple en modifiant les paramètres de configuration. Cependant, vous pouvez toujours l'utiliser pour des opérations normales, par exemple pour accéder à ses métadonnées à partir de Dataproc ou de clusters autogérés.
Les étiquettes Dataproc Metastore ne sont pas restaurées.
Les données stockées dans le répertoire d'entrepôt de données ne sont pas restaurées.
La restauration à partir d'une sauvegarde ne restaure ni ne remplace les stratégies IAM précises.

Restaurer à partir d'une sauvegarde

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

Si vous utilisez la console Google Cloud, vous ne pouvez restaurer les métadonnées qu'à partir d'une sauvegarde créée dans le même projet et la même région que votre nouveau service.
Si vous utilisez Google Cloud CLI ou les API Dataproc Metastore, vous pouvez restaurer les métadonnées à partir d'une sauvegarde créée dans un projet et une région différents (sauvegarde interservices).

Console

Dans la console Google Cloud, ouvrez la page Dataproc Metastore:

Ouvrir Dataproc Metastore
Sur la page Dataproc Metastore, cliquez sur le nom du service que vous souhaitez restaurer à partir d'une sauvegarde.

La page Détails du service s'ouvre.
Pour afficher les sauvegardes, cliquez sur l'onglet Sauvegarde/Restauration.
Sélectionnez la sauvegarde que vous souhaitez utiliser. Pour ce faire, cliquez sur l'icône de menu et sélectionnez Restaurer.

La page Restaurer s'ouvre.

Vous pouvez également restaurer votre service sur la page Détails de la sauvegarde. Pour ce faire, cliquez sur le nom de la sauvegarde, puis sur Restaurer.
Sélectionnez l'opération de restauration appropriée:
- Restaurer des données de métastore Restaure toutes les métadonnées, mais pas les paramètres de configuration enregistrés dans la sauvegarde
- Restaurer les données du métastore et la configuration du service Restaure toutes les métadonnées et tous les paramètres de configuration enregistrés dans la sauvegarde.
Pour mettre à jour le service, cliquez sur Restaurer.

Revenez à la page Dataproc Metastore et vérifiez que votre service a bien été sauvegardé.

Une fois la restauration terminée, Dataproc Metastore revient automatiquement à l'état actif, que la restauration ait réussi ou non.

gcloud CLI

Pour restaurer un service Dataproc Metastore, exécutez la commande gcloud metastore services restore suivante:
```
gcloud metastore services restore SERVICE  \
    --project=PROJECT_ID \
    --location=LOCATION \
    --backup=BACKUP \
    --restore-type=RESTORE_TYPE
```
Remplacez les éléments suivants :
- SERVICE: nom de votre service Dataproc Metastore.
- PROJECT_ID: ID du projet Google Cloud dans lequel se trouve votre service Dataproc Metastore.
- LOCATION: région Google Cloud dans laquelle se trouve votre service Dataproc Metastore.
- BACKUP: identifiant du fichier de sauvegarde à partir duquel vous effectuez la restauration. Cette valeur peut être l'ID de sauvegarde, une URL complète ou le nom relatif au format suivant : projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}.
- RESTORE_TYPE: type d'opération de restauration à effectuer. Les valeurs acceptées sont metadata-only et full. La valeur par défaut est metadata-only.
Vérifiez que l'opération de restauration a réussi.

Une fois la restauration terminée, Dataproc Metastore revient automatiquement à l'état actif, que la restauration ait réussi ou non.

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, Dataproc Metastore revient automatiquement à l'état actif, que la restauration ait réussi ou non.

Afficher l'historique de restauration

Pour afficher l'historique de restauration d'un service Dataproc Metastore dans la console Google Cloud, procédez comme suit:

Dans la console Google Cloud, ouvrez la page Dataproc Metastore.
Dans la barre de navigation, cliquez sur Sauvegarde/Restauration.

L'historique de vos restaurations s'affiche dans un tableau sous Restaurer.

L'historique affiche les 25 dernières restaurations que vous avez effectuées.

La suppression d'un service Dataproc Metastore entraîne également la suppression de l'historique de restauration associé.

Résoudre les problèmes courants

L'agent de service ou le compte utilisateur ne dispose pas des autorisations nécessaires.
Si vous avez besoin d'aide pour résoudre des problèmes courants, consultez Scénarios d'erreur de sauvegarde et de restauration.