Ripristino di un'istanza

Questa pagina descrive come ripristinare l'istanza da un backup.

Per informazioni, best practice e requisiti per le operazioni di ripristino, consulta la sezione Panoramica del ripristino di un'istanza.

Ripristina un'istanza da un backup

Puoi utilizzare un backup per ripristinare la stessa istanza da cui è stato eseguito il backup oppure un'altra istanza nello stesso progetto. Il ripristino di un'istanza da un backup richiede che le istanze di backup e di destinazione si trovino nello stesso fuso orario.

Ripristino in un'altra istanza

Quando esegui il ripristino da un backup a un'altra istanza, aggiorni i dati il giorno l'istanza di destinazione sullo stato dell'istanza di origine quando ha eseguito il backup. Per ulteriori informazioni, vedi Suggerimenti generali sull'esecuzione di un ripristino e Suggerimenti e requisiti per il ripristino in un'istanza diversa.

Se hai bisogno di un elenco di backup per il progetto e non riesci a visualizzarli nella pagina di panoramica dell'istanza a causa di un'interruzione, puoi utilizzare l'API backupRuns.list con un carattere jolly (-). L'opzione jolly recupera un elenco di tutti i backup di tutte le istanze del progetto. Per ulteriori informazioni, vedi Visualizzazione dei backup durante un'interruzione.

Console

  1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Se l'istanza di destinazione ha repliche di lettura, usa il menu Altre azioni Icona Altre azioni. all'estrema destra per eliminarle.
  3. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
  4. Seleziona Backup dal menu di navigazione SQL.
  5. Individua la copia di backup da cui vuoi eseguire il ripristino e seleziona Ripristina.
  6. Nella pagina Ripristinare un'istanza da un backup, verifica di aver selezionato il backup corretto in Rivedi i dettagli del backup.
  7. In Scegli la destinazione del ripristino, seleziona Sovrascrivi un un'istanza esistente.
  8. Nel menu a discesa Istanza, seleziona l'istanza che vuoi utilizzare per il ripristino. L'istanza selezionata e tutti i relativi dati vengono sovrascritti.
  9. Per confermare la selezione, inserisci il nome dell'istanza da sovrascrivere nel campo ID istanza di destinazione.
  10. Per avviare la procedura di ripristino, fai clic su Ripristina.
  11. Per controllare lo stato dell'operazione di ripristino, vai a Scheda Operazioni dell'istanza di destinazione.
  12. Al termine dell'operazione di ripristino, ricrea le repliche che hai eliminato in precedenza.

gcloud

  1. Descrivi l'istanza target per verificare se ha repliche: 
    gcloud sql instances describe TARGET_INSTANCE_NAME

    Prendi nota di eventuali istanze elencate in replicaNames.

  2. Elimina tutte le repliche: 
    gcloud sql instances delete REPLICA_NAME

    Ripeti l'operazione per ogni replica.

  3. Elenca i backup per l'istanza di origine: 
    gcloud sql backups list \
--instance SOURCE_INSTANCE_NAME
  4. Trova il backup che vuoi utilizzare e registra il relativo valore ID.
  5. Esegui il ripristino dal backup specificato all'istanza di destinazione: 
    gcloud sql backups restore BACKUP_ID \
--restore-instance=TARGET_INSTANCE_NAME \
--backup-instance=SOURCE_INSTANCE_NAME
  6. Al termine del ripristino, ricrea le repliche che hai eliminato in precedenza.

REST v1

  1. Elenca tutte le repliche per l'istanza target.

    Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

    • project-id: l'ID progetto
    • instance-id: l'ID istanza

    Metodo HTTP e URL: 

    GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=replicaNames

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  2. Elimina tutte le repliche.

    Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

    • project-id: l'ID progetto
    • replica-id: l'ID replica

    Metodo HTTP e URL: 

    DELETE https://sqladmin.googleapis.com/v1/projects/project-id/instances/replica-id

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

    Ripeti l'operazione per ogni replica.

  3. Elenca i backup per l'istanza di origine in modo da ottenere l'ID del che vuoi utilizzare.

    Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

    • project-id: l'ID progetto
    • instance-id: l'ID istanza

    Metodo HTTP e URL: 

    GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

    OPPURE Se la tua istanza si trova in una regione in cui si è verificata un'interruzione del servizio, elenca tutti i backup in un progetto:

    Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

    • project-id: l'ID progetto
    • instance-id: l'ID istanza o - per un elenco di tutti i backup nel progetto

    Metodo HTTP e URL: 

    GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/-/backupRuns

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

    Trova il backup per l'istanza da ripristinare.
  4. Ripristina l'istanza di destinazione dal backup.

    Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

    • project-id: l'ID progetto
    • target-instance-id: l'ID istanza di destinazione
    • source-instance-id: l'ID istanza dell'origine
    • backup-id L'ID backup

    Metodo HTTP e URL: 

    POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/target-instance-id/restoreBackup

    Corpo JSON della richiesta: 

    {
  "restoreBackupContext":
  {
    "backupRunId": backup-id,
    "instanceId": "source-instance-id"
  }
}

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  5. Al termine dell'operazione di ripristino, ricrea le repliche che hai eliminato in precedenza.

REST v1beta4

  1. Elenca tutte le repliche per l'istanza target.

    Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

    • project-id: l'ID progetto
    • instance-id: l'ID istanza

    Metodo HTTP e URL: 

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=replicaNames

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  2. Elimina tutte le repliche.

    Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

    • project-id: l'ID progetto
    • replica-id: l'ID replica

    Metodo HTTP e URL: 

    DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/replica-id

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

    Ripeti l'operazione per ogni replica.

  3. Elenca i backup per l'istanza di origine in modo da ottenere l'ID del che vuoi utilizzare.

    Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

    • project-id: l'ID progetto
    • instance-id: l'ID istanza

    Metodo HTTP e URL: 

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  4. Ripristina l'istanza di destinazione dal backup.

    Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

    • project-id: l'ID progetto
    • target-instance-id: l'ID istanza di destinazione
    • source-instance-id: l'ID istanza dell'origine
    • backup-id L'ID backup

    Metodo HTTP e URL: 

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/target-instance-id/restoreBackup

    Corpo JSON della richiesta: 

    {
  "restoreBackupContext":
  {
    "backupRunId": backup-id,
    "instanceId": "source-instance-id"
  }
}

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  5. Al termine dell'operazione di ripristino, ricrea le eventuali repliche eliminate in precedenza.

Ripristino nella stessa istanza

Quando esegui il ripristino da un backup nella stessa istanza, i dati dell'istanza tornano allo stato in cui erano al momento del backup. Per informazioni su ripristinare un'istanza, consulta Suggerimenti generali sull'esecuzione di un ripristino.

Console

  1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Se l'istanza di destinazione ha repliche di lettura, usa il menu Altre azioni Icona Altre azioni. all'estrema destra per eliminarle.
  3. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
  4. Seleziona Backup dal menu di navigazione SQL.
  5. Individua il backup che vuoi utilizzare e seleziona Ripristina.
  6. Nella pagina Ripristinare un'istanza da un backup, verifica di aver selezionato il backup corretto in Rivedi i dettagli del backup.
  7. In Scegli la destinazione del ripristino, seleziona Sovrascrivi il di origine.

    Verifica che il nome dell'istanza di origine sia specificato tra parentesi.

  8. Per confermare la selezione, inserisci il nome dell'istanza nel campo ID istanza di destinazione.
  9. Per avviare il processo di ripristino, fai clic su Ripristina.
  10. Controlla lo stato dell'operazione di ripristino nella pagina Operazioni dell'istanza.
  11. Al termine dell'operazione di ripristino, ricrea le repliche eliminate nel primo passaggio.

gcloud

  1. Descrivi l'istanza per verificare se contiene repliche: 
    gcloud sql instances describe INSTANCE_NAME

    Prendi nota di eventuali istanze elencate in replicaNames.

  2. Elimina tutte le repliche: 
    gcloud sql instances delete REPLICA_NAME

    Ripeti l'operazione per tutte le repliche.

  3. Elenca i backup per l'istanza: 
    gcloud sql backups list --instance INSTANCE_NAME
  4. Trova il backup che vuoi utilizzare e registra il relativo valore ID.
  5. Ripristina l'istanza dal backup specificato: 
    gcloud sql backups restore BACKUP_ID \
--restore-instance=INSTANCE_NAME
  6. Al termine dell'operazione di ripristino, ricrea le repliche eliminate nel primo passaggio.

REST v1

  1. Elenca i backup per l'istanza in modo da ottenere l'ID del backup che hai creato che vuoi usare.

    Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

    • project-id: l'ID progetto
    • instance-id: l'ID istanza

    Metodo HTTP e URL: 

    GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  2. Ripristina l'istanza dal backup.

    Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

    • project-id: l'ID progetto
    • instance-id: l'ID istanza
    • backup-id L'ID backup

    Metodo HTTP e URL: 

    POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/restoreBackup

    Corpo JSON della richiesta: 

    {
  "restoreBackupContext":
  {
    "backupRunId": "backup-id",
  }
}

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  3. Al termine dell'operazione di ripristino, ricrea le repliche che hai eliminato in precedenza.

REST v1beta4

  1. Elenca i backup per l'istanza per ottenere l'ID del backup che vuoi utilizzare.

    Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

    • project-id: l'ID progetto
    • instance-id: l'ID istanza

    Metodo HTTP e URL: 

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  2. Ripristina l'istanza dal backup.

    Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

    • project-id: l'ID progetto
    • instance-id: l'ID istanza
    • backup-id L'ID backup

    Metodo HTTP e URL: 

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/restoreBackup

    Corpo JSON della richiesta: 

    {
  "restoreBackupContext":
  {
    "backupRunId": "backup-id",
  }
}

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  3. Al termine dell'operazione di ripristino, ricrea le repliche che hai eliminato in precedenza.

Ripristina in un'istanza in un altro progetto

Puoi utilizzare il parametro project per ripristinare i dati in un'istanza in un diverso da quello in cui è stato eseguito il backup. Quando utilizzi il Parametro project, chiama restoreBackup nel progetto e nell'istanza su cui vuoi ripristinare i dati. Quando esegui il ripristino da un backup a un'altra istanza, aggiorni i dati sull'istanza di destinazione allo stato dell'istanza di origine quando hai eseguito il backup.

Autorizzazioni

L'utente che esegue il ripristino in un progetto diverso deve avere Autorizzazione cloudsql.instances.restoreBackup per il progetto di destinazione e l'autorizzazione cloudsql.backupRuns.get per l'istanza di origine. Queste autorizzazioni sono incluse nel ruolo Cloud SQL Admin.

Per ripristinare i dati in un'istanza di un altro progetto:

REST v1

Per ottenere backupId, esegui questo comando.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • project-id: l'ID progetto
  • instance-id: l'ID istanza

Metodo HTTP e URL: 

GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns

Per inviare la richiesta, espandi una delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Ripristina il backup in un'istanza di un altro progetto:

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • source-project-id: ID progetto di origine
  • target-project-id: l'ID progetto di destinazione
  • target-instance-id: l'ID istanza di destinazione
  • source-instance-id: l'ID istanza dell'origine
  • backup-id L'ID backup

Metodo HTTP e URL: 

POST https://sqladmin.googleapis.com/v1/projects/target-project-id/instances/target-instance-id/restoreBackup

Corpo JSON della richiesta: 

{
  "restoreBackupContext":
  {
    "backupRunId": backup-id,
    "project": "source-project-id",
    "instanceId": "source-instance-id"
  }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Per ulteriori informazioni sulla proprietà project, consulta restoreBackup

REST v1beta4

Per ottenere backupId, esegui il seguente comando.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • project-id: l'ID progetto
  • instance-id: l'ID istanza

Metodo HTTP e URL: 

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns

Per inviare la richiesta, espandi una delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Ripristina il backup in un'istanza di un altro progetto:

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • source-project-id: ID progetto di origine
  • target-project-id: l'ID progetto di destinazione
  • target-instance-id: l'ID istanza di destinazione
  • source-instance-id: l'ID istanza dell'origine
  • backup-id L'ID backup

Metodo HTTP e URL: 

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/target-project-id/instances/target-instance-id/restoreBackup

Corpo JSON della richiesta: 

{
  "restoreBackupContext":
  {
    "backupRunId": backup-id,
    "project": "source-project-id",
    "instanceId": "source-instance-id"
  }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Per ulteriori informazioni sulla proprietà project, vedi restoreBackup

Esegui un recupero point-in-time

Per eseguire un recupero point-in-time, vedi Recupero point-in-time.

Passaggi successivi