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 que puedes importar más adelante con la herramienta pg_restore.

Para realizar la exportación, debes llevar a cabo estas tareas:

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

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

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

  4. Elimina los recursos que has creado para llevar a cabo el procedimiento.

Antes de empezar

  • Debes tener el rol básico de gestión de identidades y accesos Propietario (roles/owner) o Editor (roles/editor) en el Google Cloud proyecto que estés usando, o bien debes tener estos roles de gestión de identidades y accesos predefinidos:
    • Administrador de AlloyDB (roles/alloydb.admin) o Lector de AlloyDB (roles/alloydb.viewer)
    • Administrador de almacenamiento (roles/storage.admin)
    • Administrador de instancias de Compute (v. 1) (roles/compute.instanceAdmin.v1)

Crea un segmento de Cloud Storage

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

Preparar un host de cliente

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

  1. Sigue las instrucciones de la sección Conectar 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 vas a crear.

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

Exportar 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, a continuación, 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. Para ello, consulta sus detalles.
  2. Accede a la máquina virtual de Compute Engine mediante SSH.

    Consola

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

      Ir a instancias de VM

    2. En la lista de instancias de máquinas virtuales, haz clic en SSH en la fila de la instancia que has creado.

      Botón SSH situado junto al nombre de la instancia.

    gcloud

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

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

    Haz los cambios siguientes:

    • PROJECT_ID: ID del proyecto que contiene la instancia.
    • ZONE: 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 DMP: 
    pg_dump -h IP_ADDRESS -U postgres -F custom \
  DB_NAME > DMP_FILE_NAME

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

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

    Arriba se muestra un comando pg_dump sencillo. Para obtener información sobre la amplia gama de opciones que admite el comando, consulta la documentación de PostgreSQL.

  4. Copia el archivo DMP en el segmento de Cloud Storage que has creado antes: 
    gcloud storage cp DMP_FILE_NAME gs://BUCKET_NAME

Eliminar los recursos

Una vez que hayas exportado correctamente el archivo DMP, puedes eliminar la VM de Compute Engine que has usado durante el proceso de exportación.

Siguientes pasos