Restore allows you to recover your Dataproc Metastore service's stored metadata and configuration from a backup.
This page explains how to restore a Dataproc Metastore service's metadata.
To restore metadata, you must be granted an IAM role containing the
metastore.backups.useIAM permissions. The Dataproc Metastore specific roles
roles/metastore.editorinclude restore permission.
You can give restore permission to users or groups by using the
For more information, see Dataproc Metastore IAM and access control.
Restoring a service from a backup
To restore a service from a backup, choose a backup on the Service detail page
opened in a local browser, use the
gcloud tool, or issue a
Dataproc Metastore API method services.restore.
You have the option to restore metadata with the current service configuration
or restore metadata with the backup service configuration. You can restore the
metadata and backup service configuration at the same time. The configuration
includes settings such as network, port, and service tier, which are the same
configurations that you can change using the API method
You can't make any updates to the service while a restore is pending. You can still use the service while it's undergoing a restore.
To restore a Dataproc Metastore service from a backup, complete the following steps:
In the Cloud Console, open the Dataproc Metastore page:
On the Dataproc Metastore page, click the name of the service you'd like to restore metadata into. The Service detail page opens.
Click the Backup/Restore tab to view your backups for the service.
On the right of the backup you'd like to use, clickand select Restore. The restore page opens.
You can also restore your service on the Backup detail page by clicking the name of the backup that you'd like to use, and then clicking Restore.
Select a restore option:
Restore metastore data
Only restores the data content stored in the backup.
Restore metastore data and service configuration
Restores the data content stored in the backup, and applies the service configuration stored in the backup to the current service.
Click Restore to update the service.
Verify that you have returned to the Service detail page, and that your restore appears under the Restore history on the Backup/Restore tab.
Run the following
gcloud metastore services restorecommand to restore metadata into a service:
gcloud metastore services restore SERVICE \ --location=LOCATION \ --backup=BACKUP \ --restore-type=RESTORE_TYPE --project=PROJECT_ID
Replace the following:
SERVICE: The name of the service.
LOCATION: The location of the service.
BACKUP: Refers to the backup resource to restore from. This can be the backup's ID, fully-qualified URL, or relative name.
RESTORE_TYPE: The type of restore to perform. Defaults to
PROJECT_ID: The project of the service.
Verify that the restoration was successful.
Follow the API instructions to restore metadata into a service by using the APIs Explorer.
When the restore succeeds, the service automatically enters active state. If it fails, then the service rolls back to its previous healthy state.
To view a service's restore history, refer to the Backup/Restore tab on the Service detail page in the Cloud Console.
Dataproc Metastore service labels and actual data in the datawarehouse directory are not restored.
You can only restore metadata from backups created from Dataproc Metastore services in the same project and region as the target service.
- You can use the gcloud command-line tool or REST API method to restore metadata from a cross-service backup.
A history of past restores is available on the UI. Deleting the service itself deletes all restore history under that service.
- The user restoring the Dataproc Metastore service from a backup
- Learn more about exporting metadata.
- Learn more about updating and deleting a service.
- Learn more about data storage for internal tables.