1. Descripción general
En este codelab, demostraremos un método simple y fácil de usar para configurar AlloyDB.

Qué compilarás
Como parte de esto, crearás un clúster y una instancia de AlloyDB con un solo clic, y aprenderás a configurarlos rápidamente en tus proyectos futuros.
Requisitos
2. Antes de comenzar
Crea un proyecto
- En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.
- Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Obtén información para verificar si la facturación está habilitada en un proyecto.
- Usarás Cloud Shell, un entorno de línea de comandos que se ejecuta en Google Cloud. Haz clic en Activar Cloud Shell en la parte superior de la consola de Google Cloud.

- Una vez que te hayas conectado a Cloud Shell, verifica que ya te autenticaste y que el proyecto se configuró con tu ID de proyecto con el siguiente comando:
gcloud auth list
- En Cloud Shell, ejecuta el siguiente comando para confirmar que el comando gcloud conoce tu proyecto.
gcloud config list project
- Si tu proyecto no está configurado, usa el siguiente comando para hacerlo:
gcloud config set project <YOUR_PROJECT_ID>
- Habilita las APIs necesarias: Sigue el vínculo y habilita las APIs.
Como alternativa, puedes usar el comando de gcloud para esto. Consulta la documentación para ver los comandos y el uso de gcloud.
3. ¿Por qué AlloyDB para los datos y la IA de tu empresa?
AlloyDB para PostgreSQL no es solo otro servicio de Postgres administrado. Es una modernización fundamental del motor diseñada para la era de la IA. Estos son los motivos por los que se destaca en comparación con las bases de datos estándar:
- Procesamiento híbrido transaccional y analítico (HTAP)
La mayoría de las bases de datos te obligan a transferir los datos a un almacén de datos para realizar análisis. AlloyDB tiene un motor de columnas integrado que mantiene automáticamente los datos pertinentes en un almacén de columnas en la memoria. Esto hace que las consultas analíticas sean hasta 100 veces más rápidas que PostgreSQL estándar, lo que te permite ejecutar inteligencia empresarial en tiempo real en tus datos operativos sin canalizaciones de ETL complejas.
- Integración nativa de IA:
AlloyDB une la brecha entre tus datos y la IA generativa. Con la extensión google_ml_integration, puedes llamar a los modelos de Vertex AI (como Gemini) directamente desde tus consultas en SQL. Esto significa que puedes realizar análisis de opiniones, traducciones o extracciones de entidades como una transacción de base de datos estándar, lo que garantiza la seguridad de los datos y minimiza la latencia.
- Búsqueda de vectores superior:
Si bien PostgreSQL estándar usa pgvector, AlloyDB lo potencia con el índice de ScaNN (vecinos más cercanos escalables), desarrollado por Google Research. Esto proporciona una búsqueda de similitud de vectores significativamente más rápida y una recuperación más alta a gran escala en comparación con los índices HNSW estándar que se encuentran en otras ofertas de Postgres. Te permite compilar de forma nativa aplicaciones de RAG (generación mejorada por recuperación) de alto rendimiento.
- Rendimiento a gran escala:
AlloyDB ofrece un rendimiento transaccional hasta 4 veces más rápido que PostgreSQL estándar. Separa el procesamiento del almacenamiento, lo que permite que se escalen de forma independiente. La capa de almacenamiento es inteligente y controla el procesamiento del registro de escritura anticipada (WAL) para descargar el trabajo de la instancia principal.
- Disponibilidad para empresas:
Ofrece un ANS de tiempo de actividad del 99.99%, que incluye el mantenimiento. Este nivel de confiabilidad para una base de datos compatible con PostgreSQL se logra a través de una arquitectura nativa de la nube que garantiza una recuperación rápida ante fallas y durabilidad del almacenamiento.
4. Configuración de AlloyDB
En este lab, usaremos AlloyDB como la base de datos para los datos de prueba. Utiliza clústeres para contener todos los recursos, como bases de datos y registros. Cada clúster tiene una instancia principal que proporciona un punto de acceso a los datos. Las tablas contendrán los datos reales.
Creemos un clúster, una instancia y una tabla de AlloyDB en los que se cargará el conjunto de datos de prueba.
- Haz clic en el botón o copia el siguiente vínculo en el navegador en el que accediste como usuario a la consola de Google Cloud.
- Una vez que se complete este paso, el repo se clonará en tu editor local de Cloud Shell y podrás ejecutar el siguiente comando desde la carpeta del proyecto (es importante que te asegures de estar en el directorio del proyecto):
sh run.sh
- Ahora usa la IU (haz clic en el vínculo de la terminal o en el vínculo "preview on web" de la terminal).
- Ingresa los detalles del ID del proyecto, el clúster y los nombres de las instancias para comenzar.
- Ve a tomar un café mientras se desplazan los registros. Aquí puedes leer cómo se hace esto en segundo plano.
5. Configuración ilustrada

6. Limpieza
Cuando termines este lab de prueba, no olvides borrar el clúster y la instancia de AlloyDB.
Debería limpiar el clúster junto con sus instancias.
7. Felicitaciones
¡Ya puedes comenzar!
Comienza a configurar tus datos con AlloyDB de forma rápida y sencilla.