Ripristino Pg

Usare Ripristina database da file nell'albero Connessioni quando si vuole ripristinare un backup dell'archivio PostgreSQL in un database esistente o ricreare il contenuto in un altro ambiente. Webview compila automaticamente il pg_restore comando, mostra l'ambito di ripristino effettivo e richiede una conferma preliminare prima dell'avvio.

Prerequisites

  • Un server connesso nell'estensione di PostgreSQL.
  • L'interfaccia di backup e ripristino è abilitata (pgsql.enablePgDumpRestoreUI è true per impostazione predefinita).
  • Strumenti client PostgreSQL installati nell'host di estensione, inclusa una pg_restore versione compatibile con il server di archiviazione e di destinazione. Usare la stessa versione principale del client pg_dump che ha creato l'archivio, o una versione supportata più recente. Un client meno recente può rifiutare un formato di archivio più recente. Se l'estensione non riesce a individuare il file binario installato, configurare pgsql.pgBinaryDirs e riavviare l'editor. Questa impostazione non installa gli strumenti.
  • Ruolo del database con i privilegi e la proprietà necessari per le operazioni di ripristino selezionate, incluso CREATEDB quando è abilitato Crea database .
  • Backup in un pg_restoreformato di archivio supportato, ad esempio personalizzato, tar o directory. Vengono rilevati file SQL semplici, ma la pagina avvisa che devono essere ripristinati con psql .

Quando si esegue il ripristino su un altro server, creare o eseguire la migrazione di tutti i ruoli a cui fa riferimento l'archivio prima di ripristinare la proprietà e i privilegi. Gli archivi per database non contengono definizioni di ruolo globali. I ruoli di destinazione mancanti possono causare errori di proprietà o ripristino delle autorizzazioni. Vedere Eseguire la migrazione di utenti e ruoli con dump e ripristino.

Warning

Ripristinare solo gli archivi da origini attendibili. Un ripristino può eseguire SQL scelto dagli utenti con privilegi avanzati nel server di origine, inclusi durante i ripristini parziali. L'anteprima del comando mostra gli argomenti della riga di comando, non tutto l'SQL contenuto nell'archivio. Per controllare tale SQL prima del ripristino, usare l'opzione --file descritta nel riferimento pg_restore.

Ripristina il database

  1. Nell'albero Connessioni fare clic con il pulsante destro del mouse sul server o sul database di destinazione.
  2. Selezionare Backup e ripristino>Ripristina database da file.
  3. In Ripristina database scegliere il database di destinazione e il file di backup.
  4. Selezionare una modalità di ripristino:
    • Completo ripristina completamente il contenuto dell'archivio.
    • Lo schema ripristina la struttura senza dati.
    • Solo dati vengono ripristinati senza oggetti schema.
  5. Esaminare i campi Formato e Database (archiviato nell'archivio) rilevati dopo aver selezionato il file di backup.

Usare Opzioni avanzate per perfezionare il comando di ripristino. Il pannello raggruppa le impostazioni in Ambito, Comportamento di ripristino, Prestazioni e log, Output, impostazioni a livello di database e Sicurezza. A seconda della modalità selezionata e del formato di archivio, alcune opzioni non sono più disponibili e viene spiegato il motivo.

All'avvio della pagina viene visualizzata anche un'anteprima dei comandi per poter esaminare gli argomenti generati pg_restore prima di eseguirli.

Confermare l'operazione di ripristino

Warning

Quando l'opzione Crea database è abilitata, il database il cui nome è memorizzato nell'archivio è la destinazione di ripristino. In questa modalità, la connessione/database selezionata viene usata solo per i comandi di manutenzione iniziali. Se Clean è anche abilitato, pg_restore elimina e ricrea l'intero database con il nome dell'archivio, eliminando gli oggetti e i dati esistenti, compresi anche gli elementi non presenti nel backup. Verificare il nome del server e del database di archiviazione e mantenere un backup ripristinabile prima di continuare.

Selezionare Avvia ripristino per aprire Conferma operazione di ripristino. La finestra modale di preflight riepiloga la destinazione di ripristino prima che l'estensione esegua qualsiasi operazione:

  • La destinazione di ripristino mostra il server, la connessione di destinazione o di manutenzione, il database memorizzato nell'archivio, il file di backup, la modalità di ripristino e le sezioni abilitate.
  • L'ambito mostra il numero di schemi, tabelle, indici, funzioni e trigger inclusi.
  • Le impostazioni di sicurezza riepilogano le opzioni, ad esempio l'arresto in caso di errore, la modalità a transazione singola, il ripristino della proprietà, le sottoscrizioni, le pubblicazioni, i privilegi e il comportamento del trigger.

Se il ripristino è distruttivo, la finestra modale aggiunge avvisi più forti. Ad esempio:

  • Senza Crea database, durante il ripristino con Clean viene visualizzato un avviso che indica che gli oggetti di ripristino corrispondenti possono essere eliminati e ricreati.
  • Il ripristino con Crea database verifica se il database di archivio esiste già. Se esiste e Clean non è abilitato, l'estensione blocca il ripristino invece di consentire un merge nel database esistente.
  • Quando è necessaria la conferma digitata, è necessario immettere il nome del database esattamente prima che Conferma e avvia ripristino diventi disponibile.

Dopo aver confermato, la visualizzazione stato mostra l'avanzamento e i log. Se il ripristino non riesce, la pagina mantiene disponibile l'anteprima del comando e l'output raccolto in modo da poter esaminare l'errore o usare Debug con Copilot.