Ripristina Dataproc Metastore da un backup

Questa pagina spiega come ripristinare un servizio Dataproc Metastore da un backup.

Un backup è uno snapshot delle impostazioni di configurazione e dei metadati archiviati in un servizio Dataproc Metastore. Puoi utilizzare la funzionalità di ripristino per configurare rapidamente un nuovo servizio Dataproc Metastore con i dati salvati in precedenza in un backup.

Prima di iniziare

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per ripristinare un servizio Dataproc Metastore da un backup, chiedi all'amministratore di concederti i seguenti ruoli IAM:

  • Per concedere il controllo completo delle risorse Dataproc Metastore al fine di completare un backup, esegui una delle seguenti operazioni:
  • Per utilizzare l'oggetto Cloud Storage che archivia i backup pianificati: Utente oggetto Cloud Storage (roles/storage.objectUser) sull'agente di servizio Dataproc Metastore

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per ripristinare un servizio Dataproc Metastore da un backup. Per visualizzare esattamente le autorizzazioni necessarie, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per ripristinare un servizio Dataproc Metastore da un backup, sono necessarie le seguenti autorizzazioni:

  • Per ripristinare un servizio di metadati: metastore.services.restore, metastore.backups.use
  • Per utilizzare l'oggetto Cloud Storage:
    • orgpolicy.policy.get
    • resourcemanager.projects.get
    • resourcemanager.projects.list
    • storage.managedFolders.create
    • storage.managedFolders.delete
    • storage.managedFolders.get
    • storage.managedFolders.list
    • storage.multipartUploads.*
    • storage.objects.create
    • storage.objects.delete
    • storage.objects.get
    • storage.objects.list
    • storage.objects.restore
    • storage.objects.update

Potresti anche riuscire a ottenere queste autorizzazioni con i ruoli personalizzati o altri ruoli predefiniti.

Per ulteriori informazioni su ruoli e autorizzazioni specifici di Dataproc Metastore, consulta la panoramica su IAM di Dataproc Metastore.

Informazioni sul ripristino da un backup

Quando ripristini un servizio da un backup, puoi scegliere una delle seguenti opzioni:

  • Ripristina tutti i metadati e le impostazioni di configurazione salvate nel backup.

  • Ripristina tutti i metadati, ma non le impostazioni di configurazione salvate nel backup. Il servizio mantiene invece le impostazioni di configurazione correnti.

    Le impostazioni di configurazione includono i parametri di Dataproc Metastore come nome del servizio, numero di porta e impostazioni di rete. Metadati include tutte le informazioni su database e tabelle archiviate in un servizio Dataproc Metastore.

Considerazioni

  • Mentre è in corso un'operazione di ripristino, non puoi aggiornare il servizio, ad esempio non puoi modificare le impostazioni di configurazione. Tuttavia, puoi comunque utilizzare il servizio per le normali operazioni, ad esempio per accedere ai metadati da Dataproc collegati o da cluster autogestiti.

  • Le etichette di Dataproc Metastore non vengono ripristinate.

  • I dati archiviati nella directory del warehouse non vengono ripristinati.

  • Il ripristino da un backup non ripristina né sostituisce i criteri IAM granulari.

  • Il ripristino da un backup pianificato richiede che il backup si trovi in un bucket Cloud Storage.

Ripristina da un backup

Per ripristinare un servizio Dataproc Metastore da un backup, completa i seguenti passaggi.

  • Se utilizzi la console Google Cloud, puoi ripristinare i metadati solo da un backup creato nello stesso progetto e nella stessa regione del nuovo servizio.

  • Se utilizzi le API Google Cloud CLI o Dataproc Metastore, puoi ripristinare i metadati da un backup creato in un progetto e in un'area geografica diversi (backup tra servizi).

Console

  1. Nella console Google Cloud, apri la pagina Dataproc Metastore:

    Apri Dataproc Metastore

  2. Nella pagina Dataproc Metastore, fai clic sul nome del servizio che vuoi ripristinare da un backup.

    Si apre la pagina Dettagli del servizio.

    Pagina dei dettagli del servizio
    Figura 1. Pagina dei dettagli del servizio Dataproc Metastore

  3. Per visualizzare le copie di backup, fai clic sulla scheda Backup/Ripristino.

  4. Seleziona il backup che vuoi utilizzare. Per farlo, fai clic sull'icona del menu e seleziona Ripristina.

    Viene visualizzata la pagina Ripristina.

    Puoi anche ripristinare il servizio nella pagina Dettagli backup. Per farlo, fai clic sul nome del backup e quindi su Ripristina.

  5. Seleziona l'operazione di ripristino appropriata:

    • Ripristinare i dati del metastore. Ripristina tutti i metadati, ma non le impostazioni di configurazione salvate nel backup
    • Ripristinare i dati del metastore e la configurazione del servizio. Ripristina tutti i metadati e tutte le impostazioni di configurazione salvate nel backup.

  6. Per aggiornare il servizio, fai clic su Ripristina.

    Torna alla pagina Dataproc Metastore e verifica che il backup del servizio sia stato eseguito correttamente.

    Al termine del ripristino, Dataproc Metastore torna automaticamente allo stato attivo, indipendentemente dall'esito del ripristino.

Interfaccia a riga di comando gcloud

  1. Per ripristinare un servizio Dataproc Metastore, esegui questo comando gcloud metastore services restore:

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

    Sostituisci quanto segue:

    • SERVICE: il nome del tuo servizio Dataproc Metastore.
    • PROJECT_ID: l'ID del progetto Google Cloud in cui si trova il tuo servizio Dataproc Metastore.
    • LOCATION: la regione Google Cloud in cui si trova il servizio Dataproc Metastore.
    • BACKUP: (facoltativo) l'identificatore del file di backup da cui stai eseguendo il ripristino. Questo valore può essere l'ID backup, un URL completo o il nome relativo nel seguente formato: projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}.
    • RESTORE_TYPE: il tipo di operazione di ripristino da eseguire. I valori accettati includono metadata-only o full. Il valore predefinito è metadata-only.
    • BACKUP_LOCATION: (facoltativo) la località Cloud Storage del backup pianificato. Ad esempio: gs://my-bucket/path/to/location.

  2. Verifica che l'operazione di ripristino sia riuscita.

    Al termine del ripristino, Dataproc Metastore torna automaticamente allo stato attivo, indipendentemente dall'esito del ripristino.

REST

Segui le istruzioni dell'API per ripristinare i metadati in un servizio utilizzando Explorer API.

Al termine del ripristino, Dataproc Metastore torna automaticamente allo stato attivo, indipendentemente dal fatto che il ripristino sia riuscito o meno.

Visualizza la cronologia del ripristino

Per visualizzare la cronologia del ripristino di un servizio Dataproc Metastore nella console Google Cloud, completa i seguenti passaggi:

  1. Nella console della console Google Cloud, apri la pagina Dataproc Metastore.

  2. Nella barra di navigazione, fai clic su Backup/Ripristino.

    La cronologia del ripristino viene visualizzata in una tabella sotto Ripristina.

    La cronologia mostra fino agli ultimi 25 ripristini completati.

    L'eliminazione di un servizio Dataproc Metastore comporta anche l'eliminazione di tutta la cronologia di ripristino associata.

Risolvere i problemi comuni

Passaggi successivi