Cómo exportar un archivo DMP

En esta página, se describe cómo usar la herramienta pg_dump para exportar una base de datos de AlloyDB a un archivo DMP de formato personalizado y archivado que puedes importar más tarde con la herramienta pg_restore.

El procedimiento para realizar la exportación incluye las siguientes tareas:

  1. Crea un bucket de Cloud Storage para almacenar el archivo DMP.

  2. Prepara un host cliente para realizar la operación de exportación.

  3. Exporta la base de datos al archivo de DMP.

  4. Limpia los recursos creados para realizar el procedimiento.

Antes de comenzar

  • Debes tener el rol básico de IAM de propietario (roles/owner) o editor (roles/editor) en el proyecto Google Cloud que usas, o bien debes tener estos roles de IAM predefinidos:
    • Administrador de AlloyDB (roles/alloydb.admin) o visualizador de AlloyDB (roles/alloydb.viewer)
    • Administrador de almacenamiento (roles/storage.admin)
    • Administrador de instancias de Compute (v1) (roles/compute.instanceAdmin.v1)

Cree un bucket de Cloud Storage

Crea un bucket de Standard Storage o Regional Storage en el proyecto y la región en que se ubica tu base de datos de AlloyDB.

Prepara un host cliente

Para preparar un host cliente para realizar la operación de exportación, crea una VM de Compute Engine que se pueda conectar a la instancia principal de AlloyDB en la que se encuentra tu base de datos y, luego, instala la herramienta pg_dump y Google Cloud CLI en esa VM.

  1. Sigue las instrucciones de Conecta un cliente psql a una instancia para crear una VM de Compute Engine con la conectividad adecuada y la herramienta pg_dump instalada. Cuando sigas estas instrucciones, asegúrate de asignar suficiente almacenamiento local a la VM de Compute Engine para que quepa el archivo DMP que crearás.

  2. Instala la CLI de gcloud para proporcionar acceso a la línea de comandos y crear el archivo DMP en el bucket de Cloud Storage.

Exporta la base de datos

Para exportar la base de datos a un archivo DMP, obtén la dirección IP de la instancia principal de AlloyDB en la que se encuentra tu base de datos y, luego, usa la herramienta pg_dump.

  1. Obtén la dirección IP de la instancia principal de AlloyDB en la que se encuentra tu base de datos consultando sus detalles.
  2. Establece una conexión SSH a la VM de Compute Engine.

    Console

    1. En la Google Cloud consola, ve a la página Instancias de VM.

      Ir a Instancias de VM

    2. En la lista de instancias de máquina virtual, haz clic en SSH en la fila de la instancia que creaste.

      Botón SSH junto al nombre de la instancia.

    gcloud

    Usa el comando gcloud compute ssh para conectarte a la instancia que creaste.

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

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID del proyecto que contiene la instancia.
    • ZONE: Es el nombre de la zona en la que se encuentra la instancia.
    • VM_NAME: El nombre de la instancia
  3. Exporta la base de datos a un archivo de DMP: 
    pg_dump -h IP_ADDRESS -U postgres -F custom \
  DB_NAME > DMP_FILE_NAME

    Se te pedirá que ingreses la contraseña del usuario postgres.

    • IP_ADDRESS: Es la dirección IP de la instancia principal.
    • -F custom: Establece el formato del archivo de DMP en un archivo con formato personalizado que puedes importar más tarde con la herramienta pg_restore.
    • DB_NAME: Es el nombre de la base de datos que deseas exportar.
    • DMP_FILE_NAME: Proporciona un nombre de archivo para el archivo DMP que se creará en el sistema de archivos local del host del cliente.

    En la imagen anterior, se muestra un comando pg_dump simple. Para obtener información sobre la amplia variedad de opciones que admite el comando, consulta la documentación de PostgreSQL.

  4. Copia el archivo DMP en el bucket de Cloud Storage que creaste anteriormente: 
    gcloud storage cp DMP_FILE_NAME gs://BUCKET_NAME

Limpia los recursos

Después de exportar correctamente el archivo DMP, puedes borrar la VM de Compute Engine que usaste durante el procedimiento de exportación.

¿Qué sigue?