Crea una base de datos y conéctate a ella

Crea una base de datos y conéctate a ella

En esta página, se te guiará por el proceso para crear tu primera base de datos y conectarte a ella en AlloyDB para PostgreSQL.

Las instrucciones que se proporcionan al final de esta guía de inicio rápido te guían para limpiar esta base de datos nueva. La página concluye con los próximos pasos para obtener más información sobre cómo usar AlloyDB con tus propias aplicaciones.

Antes de comenzar

Console

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. Habilita las API de Cloud necesarias para crear AlloyDB para PostgreSQL y conectarte a él.

   Habilita las APIs

   1. En el paso Confirmar proyecto, haz clic en Siguiente para confirmar el nombre del proyecto en el que realizarás cambios.

   2. En el paso Habilitar APIs, haz clic en Habilitar para habilitar lo siguiente:

      • API de AlloyDB
      • API de Compute Engine
      • API de Cloud Resource Manager
      • API de Service Networking

      La API de Service Networking es obligatoria si planeas configurar la conectividad de red a AlloyDB con una red de VPC que reside en el mismo proyecto de Google Cloud que AlloyDB.

      Se requieren las APIs de Compute Engine y Cloud Resource Manager si planeas configurar la conectividad de red a AlloyDB con una red de VPC que reside en un proyecto diferente de Google Cloud .

gcloud

1. Crea un proyecto de Google Cloud o usa uno existente:

   gcloud projects create PROJECT_ID --set-as-default
   # For an existing project
   gcloud config set project PROJECT_ID
   

   Reemplaza lo siguiente:

   • PROJECT_ID: Es el identificador permanente del proyecto.

2. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud . Descubre cómo confirmar que tienes habilitada la facturación en un proyecto.

3. Habilita las APIs de AlloyDB, Compute Engine y Resource Manager:

   gcloud services enable alloydb.googleapis.com
   gcloud services enable compute.googleapis.com
   gcloud services enable cloudresourcemanager.googleapis.com
   

4. Si planeas configurar la conectividad de red a AlloyDB con una red de VPC que reside en el mismo proyecto de Google Cloud que AlloyDB, habilita la API de Service Networking en el proyecto.

   gcloud services enable servicenetworking.googleapis.com
   

5. Si planeas configurar la conectividad de red a AlloyDB con una red de VPC que reside en un proyecto diferente de Google Cloud , confirma que las APIs de Compute Engine y Service Networking de ese proyecto estén habilitadas para que puedas configurar el acceso a los servicios privados y a la VPC compartida en ese proyecto.

   gcloud services list
   

Crear un clúster y su instancia principal

NOTA : Si planeas usar herramientas de redes privadas, puedes implementar la configuración de red privada que elijas y la instancia de AlloyDB junto con clientes, como las VMs de Compute Engine, con Terraform. Para obtener más información, consulta Soluciones simplificadas de configuración de redes en la nube.

1. En la consola de Google Cloud , ve a la página Clústeres.

   Ir a los clústeres

2. Haga clic en Crear clúster.

3. En ID de clúster, ingresa my-cluster.

4. Ingresa una contraseña. Toma nota de esta contraseña porque la usarás en esta guía de inicio rápido.

5. Mantén la versión predeterminada de la base de datos.

6. Selecciona la región us-central1 (Iowa).

7. Selecciona la red predeterminada.

   Si tienes una conexión de acceso privado, continúa con el siguiente paso. De lo contrario, haz clic en Configurar conexión y sigue estos pasos:

   1. En Asigna un rango de IP, haz clic en Usar un rango de IP asignado automáticamente.

   2. Haz clic en Continuar y, luego, en Crear conexión.

8. Conserva el ID de instancia predeterminado, my-cluster-primary.

9. En Disponibilidad zonal, conserva Zona única como la opción seleccionada. Si bien no recomendamos una instancia de zona única para la producción, en esta guía de inicio rápido, usarás una sola zona para minimizar los costos. Para obtener más información, consulta Reduce los costos con instancias básicas.

10. Selecciona el tipo de máquina 2 vCPU, 16 GB.

11. Conserva la configuración predeterminada en Conectividad y Seguridad de la red.

12. No realices cambios en Mostrar opciones avanzadas.

13. Haga clic en Crear clúster. Es posible que AlloyDB tarde varios minutos en crear el clúster y mostrarlo en la página Resumen del clúster principal.

Conéctate a tu instancia y crea una base de datos

1. En la consola de Google Cloud , ve a la página Clústeres.

   Ir a los clústeres

2. Haz clic en el nombre de tu clúster, my-cluster, en la columna Nombre del recurso.

3. En el panel de navegación, haz clic en AlloyDB Studio.

4. En la página Sign in to AlloyDB Studio, sigue estos pasos:

   1. Selecciona la base de datos postgres.

   2. Selecciona el usuario postgres.

   3. Ingresa la contraseña que creaste en Crea un clúster y su instancia principal.

   4. Haz clic en Autenticar. En el panel Explorador, se muestra una lista de los objetos de la base de datos postgres.

5. Para crear una base de datos, ingresa la siguiente sentencia en la pestaña Editor 1 y, luego, haz clic en Ejecutar:

   CREATE DATABASE guestbook;
   

   Sabrás que se creó tu base de datos cuando aparezca el mensaje Statement executed successfully en el panel Resultados.

Conéctate a la base de datos guestbook

1. En la consola de Google Cloud , ve a la página Clústeres.

   Ir a los clústeres

2. Haz clic en el nombre de tu clúster, my-cluster, en la columna Nombre del recurso.

3. En el panel de navegación, haz clic en AlloyDB Studio.

4. En la página Sign in to AlloyDB Studio, sigue estos pasos:

   1. Selecciona la base de datos guestbook.

   2. Selecciona el usuario postgres.

   3. Ingresa la contraseña que creaste en Crea un clúster y su instancia principal.

   4. Haz clic en Autenticar. En el panel Explorador, se muestra una lista de los objetos de la base de datos guestbook.

Verifica la conexión de tu base de datos

1. Sigue los pasos que se indican en Cómo conectarse a la base de datos de guestbook.

2. Para insertar datos de muestra en la base de datos guestbook, ingresa lo siguiente en la pestaña Editor 1:

   CREATE TABLE entries (guestName VARCHAR(255),
                         content VARCHAR(255),
                         entryID SERIAL PRIMARY KEY);
   INSERT INTO entries (guestName, content) values ('Alex', 'I got here!');
   INSERT INTO entries (guestName, content) values ('Kai', 'Me too!');
   

3. Haz clic en Ejecutar. El mensaje Statement executed successfully en el panel Resultados indica que se insertan datos en tu base de datos.

4. Para quitar texto de la pestaña Editor 1 y poder ejecutar otro comando, haz clic en Borrar.

5. Para seleccionar todas las entradas de la base de datos, ingresa la siguiente consulta en la pestaña Editor 1:

   SELECT * FROM entries;
   

6. Haz clic en Ejecutar. En el panel Resultados, aparece un resultado similar al siguiente:

       guestname     | content     | entryid
       --------------+-------------+---------
       Alex          | I got here! | 1
       Kai           | Me too!     | 2
   

Limpia

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página.

1. En la consola de Google Cloud , ve a la página Clústeres.

   Ir a los clústeres

2. Haz clic en el nombre de tu clúster, my-cluster, en la columna Nombre del recurso.

3. Haz clic en Borrar clúster.

4. En Delete cluster my-cluster, ingresa my-cluster para confirmar que quieres borrar el clúster.

5. Haz clic en Borrar.

6. Si creaste una conexión privada cuando creaste un clúster, ve a la consola de Google Cloud , ve a la página Redes y haz clic en Borrar red de VPC.

¿Qué sigue?

• Habilita el acceso del proyecto a AlloyDB

• Otorga acceso a otros usuarios

• Habilita el acceso privado a los servicios

• Crea un clúster y su instancia principal

• Más información sobre las recomendaciones de tamaño