GSP1083
Descripción general
AlloyDB para PostgreSQL es un servicio de base de datos completamente administrado, compatible con PostgreSQL, que está diseñado para las 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, realizarás varias tareas fundamentales y clave para crear y administrar instancias y bases de datos de AlloyDB para PostgreSQL.
Actividades
En este lab, aprenderás a realizar las siguientes tareas:
- Crear un clúster y una instancia
- Crear tablas e insertar datos en tu base de datos
- Usar Google Cloud CLI con AlloyDB
- Borrar una instancia
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
-
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
-
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.
-
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.
-
Haz clic en Siguiente.
-
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.
-
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.
-
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.
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.
-
Haz clic en Activar Cloud Shell
en la parte superior de la consola de Google Cloud.
-
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.
- Puedes solicitar el nombre de la cuenta activa con este comando (opcional):
gcloud auth list
- Haz clic en Autorizar.
Resultado:
ACTIVE: *
ACCOUNT: {{{user_0.username | "ACCOUNT"}}}
To set the active account, run:
$ gcloud config set account `ACCOUNT`
- 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: Crea un clúster y una instancia
-
Primero, crea un clúster de AlloyDB. En el menú de navegación de la consola de Cloud (
), haz clic en Ver todos los productos. Desplázate hacia abajo hasta la sección Bases de datos y, luego, selecciona AlloyDB para PostgreSQL.
-
Haz clic en Crear clúster en la parte superior de la página.
-
En la sección Configura tu clúster, completa los siguientes campos. Asegúrate de seleccionar el valor de Región que se indica a continuación. En los demás campos, deja los valores predeterminados.
| Elemento |
Valor |
| ID del clúster |
lab-cluster |
| Contraseña |
Change3Me |
| Región |
|
| Red |
peering-network |
-
La opción de conexión de acceso privado a servicios se configuró para este proyecto cuando iniciaste el lab. Este paso es obligatorio para permitir el acceso al clúster de AlloyDB.
-
En Configura tu instancia principal, establece el ID de la instancia como lab-instance.
-
Selecciona Múltiples zonas (con alta disponibilidad) en la sección Disponibilidad zonal.
-
Selecciona 2 CPU virtuales, 16 GB como tu tipo de máquina.
-
Desplázate hasta el final de la página y haz clic en Crear clúster.
Nota: El proceso de creación del clúster tardará entre 9 y 13 minutos aproximadamente.
-
Ahora estás en la página de descripción general del clúster nuevo que creaste. En la sección inferior, hay detalles sobre tu instancia. Haz clic en Ver la configuración de conectividad en la sección de la instancia del lab. 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. No incluyas el número de puerto.
-
Haz clic en Revisar mi progreso para verificar el objetivo.
Crear un clúster y una instancia
Tarea 2: Crea tablas e inserta datos en tu base de datos
-
Al inicio del lab, se aprovisionó una VM llamada alloydb-client que contiene el cliente de PostgreSQL.
-
En el menú de navegación (
), en Compute Engine, haz clic en Instancias de VM.
-
Para la instancia llamada alloydb-client, en la columna Conectar, haz clic en SSH para abrir una ventana de terminal.
-
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
- 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
- Usa el siguiente comando para iniciar el cliente de PostgreSQL (psql). Se te pedirá que proporciones la contraseña del usuario postgres (Change3Me) que ingresaste cuando creaste el clúster.
psql -h $ALLOYDB -U postgres
- Se te presentará el prompt de la terminal psql, como se muestra a continuación.
psql (14.5 (Debian 14.5-1.pgdg110+1), server 14.4)
SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off)
Type "help" for help.
postgres=>
- Ingresa y ejecuta el siguiente comando de SQL para crear una tabla nueva llamada regions.
CREATE TABLE regions (
region_id bigint NOT NULL,
region_name varchar(25)
) ;
ALTER TABLE regions ADD PRIMARY KEY (region_id);
- A continuación, agrega varias filas de datos a la tabla regions. Ingresa y ejecuta el siguiente comando de SQL.
INSERT INTO regions VALUES ( 1, 'Europe' );
INSERT INTO regions VALUES ( 2, 'Americas' );
INSERT INTO regions VALUES ( 3, 'Asia' );
INSERT INTO regions VALUES ( 4, 'Middle East and Africa' );
- Ejecuta la siguiente consulta simple para verificar que insertaste los registros.
SELECT region_id, region_name from regions;
-
Escribe \q para salir del cliente psql.
-
Otra opción para crear tablas o cargar datos es usar un archivo SQL (.sql). Un archivo SQL puede contener DDL, DML o cualquier sintaxis de SQL compatible. Descargarás un archivo que contiene DDL y DML. Luego, ejecutarás ese archivo y verificarás la carga.
-
Ejecuta el siguiente comando para descargar un archivo que contiene DDL y DML para tres tablas: countries, departments y jobs.
gsutil cp gs://spls/gsp1083/hrm_load.sql hrm_load.sql
- Vuelve a conectarte al cliente de PostgreSQL (psql). Se te pedirá que proporciones la contraseña del usuario postgres (Change3Me).
psql -h $ALLOYDB -U postgres
- Ejecuta el siguiente comando para procesar el archivo SQL.
\i hrm_load.sql
- Ejecuta el siguiente comando para ver las tablas que se cargaron en tu base de datos.
\dt
List of relations
Schema | Name | Type | Owner
--------+-------------+-------+----------
public | countries | table | postgres
public | departments | table | postgres
public | jobs | table | postgres
public | regions | table | postgres
(4 rows)
- Ejecuta una consulta de verificación aleatoria para examinar los datos en una de las tablas que acabas de crear y cargar.
select job_title, max_salary
from jobs
order by max_salary desc;
-
Escribe \q para salir del cliente psql.
-
Escribe exit para cerrar la ventana de terminal.
-
Haz clic en Revisar mi progreso para verificar el objetivo.
Crear y cargar una tabla
Tarea 3: Usa Google Cloud CLI con AlloyDB
La consola de Cloud es muy útil, pero en algunos casos de uso, querrás administrar bases de datos de AlloyDB con otros métodos. Los servicios de Google Cloud también pueden administrarse a través de la herramienta de línea de comandos llamada gcloud. La forma más fácil de usar gcloud CLI es a través de Cloud Shell, pero también se puede instalar en una amplia variedad de sistemas operativos.
Crea un clúster y una instancia con la CLI
-
Crear una instancia de clústeres de AlloyDB con gcloud es muy sencillo. Haz clic en Activar Cloud Shell
en la parte superior de la consola de Google Cloud.
-
En Cloud Shell, crea un nuevo clúster de AlloyDB con el siguiente comando.
gcloud alloydb clusters create gcloud-lab-cluster \
--password=Change3Me \
--network=peering-network \
--region={{{primary_project.default_region|Default Region}}} \
--project={{{primary_project.project_id|Project ID}}}
- Una vez que se cree el clúster, ejecuta el siguiente comando para crear la instancia principal.
Nota: El proceso de creación de la instancia tardará entre 7 y 9 minutos.
gcloud alloydb instances create gcloud-lab-instance\
--instance-type=PRIMARY \
--cpu-count=2 \
--region={{{primary_project.default_region|Default Region}}} \
--cluster=gcloud-lab-cluster \
--project={{{primary_project.project_id|Project ID}}}
- Una vez que se complete el proceso, puedes ejecutar el siguiente comando para enumerar las instancias de clústeres de AlloyDB disponibles en tu proyecto. En la lista, se devuelven la instancia anterior que creaste (lab-cluster) y la que acabas de crear (gcloud-lab-cluster).
gcloud alloydb clusters list
- Haz clic en Revisar mi progreso para verificar el objetivo.
Crear un clúster y una instancia con la CLI
Tarea 4: Borra un clúster
- Una forma muy rápida de borrar un clúster es a través de la CLI. Ejecuta el siguiente comando. La opción force también borra las instancias subordinadas. Otra opción para borrar un clúster es usar la consola de Cloud.
Nota: El proceso de eliminación tardará entre 5 y 8 minutos.
gcloud alloydb clusters delete gcloud-lab-cluster \
--force \
--region={{{primary_project.default_region|Default Region}}} \
--project={{{primary_project.project_id|Project ID}}}
- Para confirmar que se borró gcloud-lab-cluster, ejecuta el siguiente comando:
Si aparece la pregunta Do you want to continue (Y/n)?, presiona Y para continuar.
gcloud alloydb clusters list
¡Felicitaciones!
Ahora tienes conocimientos sólidos de varias tareas clave relacionadas con el uso de una base de datos de AlloyDB para PostgreSQL.
Actualización más reciente del manual: 15 de septiembre de 2025
Prueba más reciente del lab: 15 de septiembre de 2025
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.