Esportare un file DMP

Questa pagina descrive come utilizzare lo strumento pg_dump per esportare un database AlloyDB in un file DMP di archivio in formato personalizzato che puoi importare in un secondo momento utilizzando lo strumento pg_restore.

La procedura per eseguire l'esportazione prevede le seguenti attività:

  1. Crea un bucket Cloud Storage in cui archiviare il file DMP.

  2. Prepara un host client per eseguire l'operazione di esportazione.

  3. Esporta il database nel file DMP.

  4. Eseguire la pulizia delle risorse create per eseguire la procedura.

Prima di iniziare

  • Devi disporre del ruolo IAM di base Proprietario (roles/owner) o Editor (roles/editor) nel progetto Google Cloud che utilizzi oppure devi disporre di questi ruoli IAM predefiniti:
    • AlloyDB Admin (roles/alloydb.admin) o AlloyDB Viewer (roles/alloydb.viewer)
    • Amministratore Storage (roles/storage.admin)
    • Amministratore istanze Compute (v1) (roles/compute.instanceAdmin.v1)

Crea un bucket Cloud Storage

Crea un bucket di archiviazione regionale di archiviazione standard nel progetto e nella regione in cui si trova il tuo database AlloyDB.

Prepara un host client

Per preparare un host client a eseguire l'operazione di esportazione, crea una VM Compute Engine che possa connettersi all'istanza primaria AlloyDB in cui si trova il database e installa lo strumento pg_dump e Google Cloud CLI su questa VM.

  1. Segui le istruzioni Connetti un client psql a un'istanza per creare una VM Compute Engine con la connettività corretta e lo strumento pg_dump installato. Quando segui queste istruzioni, assicurati di allocare spazio di archiviazione locale sufficiente alla VM Compute Engine per ospitare il file DMP che creerai.

  2. Installa gcloud CLI per fornire l'accesso alla riga di comando per creare il file DMP nel bucket Cloud Storage.

Esporta il database

Per esportare il database in un file DMP, recupera l'indirizzo IP dell'istanza principale di AlloyDB in cui si trova il tuo database e poi utilizza lo strumento pg_dump.

  1. Recupera l'indirizzo IP dell'istanza principale di AlloyDB in cui si trova il tuo database visualizzandone i dettagli.
  2. Accedi tramite SSH alla VM Compute Engine.

    Console

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

      Vai a Istanze VM

    2. Nell'elenco delle istanze della macchina virtuale, fai clic su SSH nella riga dell'istanza che hai creato.

      Pulsante SSH accanto al nome dell'istanza.

    gcloud

    Utilizza il comando gcloud compute ssh per connetterti all'istanza che hai creato.

    gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del progetto che contiene l'istanza.
    • ZONE: il nome della zona in cui si trova l'istanza.
    • VM_NAME: il nome dell'istanza.
  3. Esporta il database in un file DMP: 
    pg_dump -h IP_ADDRESS -U postgres -F custom \
  DB_NAME > DMP_FILE_NAME

    Ti verrà chiesto di inserire la password dell'utente postgres.

    • IP_ADDRESS: L'indirizzo IP dell'istanza primaria.
    • -F custom: imposta il formato del file DMP su un archivio in formato personalizzato che puoi importare in un secondo momento utilizzando lo strumento pg_restore.
    • DB_NAME: il nome del database che vuoi esportare.
    • DMP_FILE_NAME: fornisci un nome file per il file DMP da creare nel file system locale dell'host client.

    Quanto sopra mostra un semplice comando pg_dump. Per informazioni sull'ampia gamma di opzioni supportate dal comando, consulta la documentazione di PostgreSQL.

  4. Copia il file DMP nel bucket Cloud Storage che hai creato in precedenza: 
    gcloud storage cp DMP_FILE_NAME gs://BUCKET_NAME

Esegui la pulizia delle risorse

Dopo aver esportato correttamente il file DMP, puoi eliminare la VM Compute Engine che hai utilizzato durante la procedura di esportazione.

Passaggi successivi