Instrucciones y requisitos de configuración del lab
Protege tu cuenta y tu progreso. Usa siempre una ventana de navegador privada y las credenciales del lab para ejecutarlo.

Migra a AlloyDB desde PostgreSQL usando herramientas de PostgreSQL

Lab 20 minutos universal_currency_alt 1 crédito show_chart Introductorio
info Es posible que este lab incorpore herramientas de IA para facilitar tu aprendizaje.
Este contenido aún no está optimizado para dispositivos móviles.
Para obtener la mejor experiencia, visítanos en una computadora de escritorio con un vínculo que te enviaremos por correo electrónico.

GSP1085

Logotipo de los labs de autoaprendizaje de Google Cloud

Descripción general

AlloyDB para PostgreSQL es un servicio de base de datos completamente administrado y compatible con PostgreSQL para tus cargas de trabajo de bases de datos empresariales más exigentes. AlloyDB combina lo mejor de Google con uno de los motores de base de datos de código abierto más populares, PostgreSQL, para un rendimiento, escalamiento y disponibilidad superiores.

En este lab, migrarás una base de datos de PostgreSQL independiente (que se ejecuta en una máquina virtual) a AlloyDB para PostgreSQL usando herramientas nativas de PostgreSQL. Una de las opciones de migración de bases de datos que admite AlloyDB es la importación de un archivo DMP. El archivo DMP se debe crear con la herramienta pg_dump con el parámetro de configuración de formato personalizado o de directorio. El DMP se debe importar con la herramienta pg_restore.

Actividades

En este lab, aprenderás a realizar las siguientes tareas:

  • Verificar los datos en la instancia de origen para la migración
  • Crear un archivo DMP de la base de datos con pg_dump
  • Importar el archivo DMP con pg_restore

Configuración y requisitos

Antes de hacer clic en el botón Comenzar lab

Lee estas instrucciones. Los labs cuentan con un temporizador que no se puede pausar. El temporizador, que comienza a funcionar cuando haces clic en Comenzar lab, indica por cuánto tiempo tendrás a tu disposición los recursos de Google Cloud.

Este lab práctico te permitirá realizar las actividades correspondientes en un entorno de nube real, no en uno de simulación o demostración. Para ello, se te proporcionan credenciales temporales nuevas que utilizarás para acceder a Google Cloud durante todo el lab.

Para completar este lab, necesitarás lo siguiente:

  • Acceso a un navegador de Internet estándar. Se recomienda el navegador Chrome.
Nota: Usa una ventana del navegador privada o de incógnito (opción recomendada) para ejecutar el lab. Así evitarás conflictos entre tu cuenta personal y la cuenta de estudiante, lo que podría generar cargos adicionales en tu cuenta personal.
  • Tiempo para completar el lab (recuerda que, una vez que comienzas un lab, no puedes pausarlo).
Nota: Usa solo la cuenta de estudiante para este lab. Si usas otra cuenta de Google Cloud, es posible que se apliquen cargos a esa cuenta.

Cómo iniciar tu lab y acceder a la consola de Google Cloud

  1. Haz clic en el botón Comenzar lab. Si debes pagar por el lab, se abrirá un diálogo para que selecciones la forma de pago. A la izquierda, se encuentra el panel Detalles del lab, que tiene estos elementos:

    • El botón para abrir la consola de Google Cloud
    • El tiempo restante
    • Las credenciales temporales que debes usar para el lab
    • Otra información para completar el lab, si es necesaria
  2. Haz clic en Abrir la consola de Google Cloud (o haz clic con el botón derecho y selecciona Abrir el vínculo en una ventana de incógnito si ejecutas el navegador Chrome).

    El lab inicia recursos y abre otra pestaña en la que se muestra la página de acceso.

    Sugerencia: Ordena las pestañas en ventanas separadas, una junto a la otra.

    Nota: Si ves el diálogo Elegir una cuenta, haz clic en Usar otra cuenta.
  3. De ser necesario, copia el nombre de usuario a continuación y pégalo en el diálogo Acceder.

    {{{user_0.username | "Username"}}}

    También puedes encontrar el nombre de usuario en el panel Detalles del lab.

  4. Haz clic en Siguiente.

  5. Copia la contraseña que aparece a continuación y pégala en el diálogo Te damos la bienvenida.

    {{{user_0.password | "Password"}}}

    También puedes encontrar la contraseña en el panel Detalles del lab.

  6. Haz clic en Siguiente.

    Importante: Debes usar las credenciales que te proporciona el lab. No uses las credenciales de tu cuenta de Google Cloud. Nota: Usar tu propia cuenta de Google Cloud para este lab podría generar cargos adicionales.
  7. Haz clic para avanzar por las páginas siguientes:

    • Acepta los Términos y Condiciones.
    • No agregues opciones de recuperación o autenticación de dos factores (esta es una cuenta temporal).
    • No te registres para obtener pruebas gratuitas.

Después de un momento, se abrirá la consola de Google Cloud en esta pestaña.

Nota: Para acceder a los productos y servicios de Google Cloud, haz clic en el menú de navegación o escribe el nombre del servicio o producto en el campo Buscar. Ícono del menú de navegación y campo de búsqueda

Activa Cloud Shell

Cloud Shell es una máquina virtual que cuenta con herramientas para desarrolladores. Ofrece un directorio principal persistente de 5 GB y se ejecuta en Google Cloud. Cloud Shell proporciona acceso de línea de comandos a tus recursos de Google Cloud.

  1. Haz clic en Activar Cloud Shell Ícono de Activar Cloud Shell en la parte superior de la consola de Google Cloud.

  2. Haz clic para avanzar por las siguientes ventanas:

    • Continúa en la ventana de información de Cloud Shell.
    • Autoriza a Cloud Shell para que use tus credenciales para realizar llamadas a la API de Google Cloud.

Cuando te conectes, habrás completado la autenticación, y el proyecto estará configurado con tu Project_ID, . El resultado contiene una línea que declara el Project_ID para esta sesión:

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

gcloud es la herramienta de línea de comandos de Google Cloud. Viene preinstalada en Cloud Shell y es compatible con la función de autocompletado con tabulador.

  1. Puedes solicitar el nombre de la cuenta activa con este comando (opcional):
gcloud auth list
  1. Haz clic en Autorizar.

Resultado:

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`
  1. Puedes solicitar el ID del proyecto con este comando (opcional):
gcloud config list project

Resultado:

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} Nota: Para obtener toda la documentación de gcloud, en Google Cloud, consulta la guía con la descripción general de gcloud CLI.

Tarea 1: Verificar los datos en la instancia de origen para la migración

  1. En el menú de navegación (console_nav_small.png), en Compute Engine, haz clic en Instancias de VM.

  2. Para la instancia llamada pg14-source, en la columna Conectar, haz clic en SSH para abrir una ventana de terminal.

  3. Usa el siguiente comando para iniciar el cliente de PostgreSQL (psql).

sudo -u postgres psql
  1. Se te presentará una solicitud de terminal psql similar a la que se muestra a continuación.
psql (14.5 (Debian 14.5-1.pgdg110+1)) Escribe "help" para obtener ayuda.
  1. Ingresa y ejecuta el siguiente comando de SQL para ver las tablas relacionadas con RR.HH. en la base de datos postgres.
\dt List of relations Schema | Name | Type | Owner --------+-------------+-------+---------- public | countries | table | postgres public | departments | table | postgres public | employees | table | postgres public | jobs | table | postgres public | locations | table | postgres public | regions | table | postgres (6 rows)
  1. Ejecuta las siguientes consultas para determinar los recuentos de filas de cada tabla.
select count (*) as countries_row_count from countries; select count (*) as departments_row_count from departments; select count (*) as employees_row_count from employees; select count (*) as jobs_row_count from jobs; select count (*) as locations_row_count from locations; select count (*) as regions_row_count from regions;
  1. Los recuentos de filas de la tabla de origen son los siguientes.
Nombre Filas
países 25
departamentos 27
empleados 107
trabajos 19
ubicaciones 23
regiones 4



  1. Escribe \q para salir del cliente psql.

Tarea 2: Crea un archivo DMP de la base de datos con pg_dump

  1. La herramienta pg_dump se incluye de forma predeterminada con cada instalación de PostgreSQL. En la terminal pg14-source, crea un archivo DMP de la base de datos de Postgres que contenga las tablas de RR.HH. que examinaste anteriormente. Ejecuta el siguiente comando en el prompt de la shell. Nota: La marca "-Fc" designa un archivo de DMP con formato personalizado.
sudo -u postgres pg_dump -Fc postgres > pg14_source.DMP
  1. Navega por el directorio para confirmar el tamaño y otros detalles del archivo DMP.
ls -l -h pg14_source.DMP -rw-r--r-- 1 student-03-171e0d8475af google-sudoers 13K Aug 27 21:19 pg14_source.DMP
  1. Para simular una rutina de exportación o importación de bases de datos, migra el archivo DMP a un bucket de Cloud Storage. Al inicio del lab, se creó un bucket con el nombre de tu ID del proyecto de Qwiklabs.
gsutil cp pg14_source.DMP gs://{{{primary_project.project_id|Project ID}}}/pg14_source.DMP
  1. Haz clic en Revisar mi progreso para verificar el objetivo.
Subir el archivo DMP de la base de datos a Cloud Storage

Tarea 3: Importa el archivo DMP con pg_restore

  1. Cuando iniciaste el lab, se aprovisionaron un clúster y una instancia de AlloyDB. En el menú de navegación de la consola de Cloud (console_nav_small.png), en Bases de datos, haz clic en AlloyDB para PostgreSQL y, luego, en Clústeres para examinar los detalles del clúster.

  2. El clúster se llama lab-cluster y la instancia se llama lab-instance.

  3. Anota la dirección IP privada que se encuentra en la sección de instancias. Copia la dirección de IP privada en un archivo de texto para que puedas pegar el valor en un paso posterior. La instancia tarda un tiempo en crearse y, luego, inicializarse por completo. Espera hasta que veas el Estado como Listo para continuar con el siguiente paso.

  4. Al inicio del lab, se aprovisionó una VM llamada alloydb-client que contiene el cliente de PostgreSQL. Esta instalación incluye la herramienta de restablecimiento de bases de datos pg_restore.

  5. En el menú de navegación (Ícono del menú de navegación), en Compute Engine, haz clic en Instancias de VM.

  6. Para la instancia llamada alloydb-client, en la columna Conectar, haz clic en SSH para abrir una ventana de terminal.

  7. Establece la siguiente variable de entorno y reemplaza ALLOYDB_ADDRESS por la dirección IP privada de la instancia de AlloyDB.

export ALLOYDB=ALLOYDB_ADDRESS
  1. Para almacenar la dirección IP privada de la instancia de AlloyDB en la VM cliente de AlloyDB, de modo que persista durante todo el lab, ejecuta este comando.
echo $ALLOYDB > alloydbip.txt
  1. Usa el siguiente comando para iniciar el cliente de PostgreSQL (psql). Se te pedirá que proporciones la contraseña del usuario de postgres (Change3Me) que se especificó cuando se creó el clúster.
psql -h $ALLOYDB -U postgres
  1. Ejecuta el siguiente comando para confirmar que la base de datos de Postgres está vacía.
\dt No se encontraron relaciones.
  1. Escribe \q para salir del cliente psql.

  2. Descarga el archivo DMP del bucket de Cloud Storage en el directorio local.

gsutil cp gs://{{{primary_project.project_id|Project ID}}}/pg14_source.DMP pg14_source.DMP
  1. Ejecuta el siguiente comando para crear un archivo TOC que marque como comentario todas las sentencias extension.
pg_restore -l pg14_source.DMP | sed -E 's/(.* EXTENSION )/; \1/g' > pg14_source_toc.toc
  1. Ahora ejecuta el comando restore para cargar las tablas de RR.HH. Se te pedirá la contraseña del usuario postgres: Change3Me.
pg_restore -h $ALLOYDB -U postgres \ -d postgres \ -L pg14_source_toc.toc \ pg14_source.DMP
  1. Vuelve a iniciar el cliente de PostgreSQL (psql). Se te pedirá la contraseña del usuario postgres: Change3Me.
psql -h $ALLOYDB -U postgres
  1. Ejecuta el siguiente comando para confirmar que se cargaron las tablas.
\dt List of relations Schema | Name | Type | Owner --------+-------------+-------+---------- public | countries | table | postgres public | departments | table | postgres public | employees | table | postgres public | jobs | table | postgres public | locations | table | postgres public | regions | table | postgres (6 rows)
  1. Ejecuta las siguientes consultas para determinar los recuentos de filas de las tablas migradas. Los valores coincidirán con los resultados de la consulta en la instancia de origen.
select count (*) as countries_row_count from countries; select count (*) as departments_row_count from departments; select count (*) as employees_row_count from employees; select count (*) as jobs_row_count from jobs; select count (*) as locations_row_count from locations; select count (*) as regions_row_count from regions;
  1. Haz clic en Revisar mi progreso para verificar el objetivo.
Verificar la importación del archivo DMP de la base de datos

¡Felicitaciones!

Ahora migraste correctamente una base de datos de PostgreSQL independiente (que se ejecuta en una máquina virtual) a AlloyDB para PostgreSQL usando herramientas nativas de PostgreSQL.

Última actualización del manual: 26 de abril de 2024

Prueba más reciente del lab: 2 de agosto de 2023

Copyright 2026 Google LLC. All rights reserved. Google y el logotipo de Google son marcas de Google LLC. Los demás nombres de productos y empresas pueden ser marcas de las respectivas empresas a las que estén asociados.

Antes de comenzar

  1. Los labs crean un proyecto de Google Cloud y recursos por un tiempo determinado
  2. .
  3. Los labs tienen un límite de tiempo y no tienen la función de pausa. Si finalizas el lab, deberás reiniciarlo desde el principio.
  4. En la parte superior izquierda de la pantalla, haz clic en Comenzar lab para empezar

Usa la navegación privada

  1. Copia el nombre de usuario y la contraseña proporcionados para el lab
  2. Haz clic en Abrir la consola en modo privado

Accede a la consola

  1. Accede con tus credenciales del lab. Si usas otras credenciales, se generarán errores o se incurrirá en cargos.
  2. Acepta las condiciones y omite la página de recursos de recuperación
  3. No hagas clic en Finalizar lab, a menos que lo hayas terminado o quieras reiniciarlo, ya que se borrará tu trabajo y se quitará el proyecto

Este contenido no está disponible en este momento

Te enviaremos una notificación por correo electrónico cuando esté disponible

¡Genial!

Nos comunicaremos contigo por correo electrónico si está disponible

Un lab a la vez

Confirma para finalizar todos los labs existentes y comenzar este

Usa la navegación privada para ejecutar el lab

Usar una ventana de incógnito o de navegación privada es la mejor forma de ejecutar este lab. Así evitarás cualquier conflicto entre tu cuenta personal y la cuenta de estudiante, lo que podría generar cargos adicionales en tu cuenta personal.