Crea y consulta una base de datos de AlloyDB con la consola de Google Cloud

Crea y consulta una base de datos de AlloyDB con la consola de Google Cloud

Para comenzar a usar AlloyDB para PostgreSQL en la consola de Google Cloud , puedes crear un clúster y una instancia principal, conectarte a la instancia con AlloyDB Studio, y, luego, insertar y consultar datos de muestra. En AlloyDB, tus bases de datos se almacenan en clústeres que contienen instancias. Para obtener más información sobre la arquitectura, los clústeres y las instancias de AlloyDB, consulta Descripción general de AlloyDB.

Antes de comenzar

Accede a tu cuenta de Google Cloud . Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, AlloyDB, Cloud Resource Manager, and Service Networking APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, AlloyDB, Cloud Resource Manager, and Service Networking APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

1. La API de Service Networking es necesaria si planeas configurar la conectividad de red a AlloyDB con una red de nube privada virtual (VPC) que resida en el mismo proyecto de Google Cloud que AlloyDB.

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

2. Elige una opción de conectividad.

Roles obligatorios

Para obtener los permisos que necesitas para crear una base de datos de AlloyDB y conectarte a ella, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:

• Administrador de red de Compute (roles/compute.networkAdmin)
• Administrador de AlloyDB (roles/alloydb.admin)

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para crear una base de datos de AlloyDB y conectarse a ella. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para crear una base de datos de AlloyDB y conectarse a ella:

• compute.networks.list
• compute.networks.addPeering
• compute.addresses.create
• servicenetworking.services.addPeering
• alloydb.clusters.create
• alloydb.instances.create
• alloydb.instances.login

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Crea un clúster y su instancia principal de AlloyDB

Nota: Para configurar un clúster, una instancia y una red para tu entorno de desarrollo con una guía interactiva, sigue los pasos del codelab de configuración de AlloyDB.

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 Configura tu clúster, sigue estos pasos:

   1. En el campo ID del clúster, ingresa my-cluster.

   2. Ingresa una contraseña. Toma nota de esta contraseña, ya que la usarás en esta guía de inicio rápido.

   3. Conserva la versión predeterminada de la base de datos.

   4. En el menú Región, en Ubicación, selecciona la región us-central1 (Iowa).

4. En Configura tu instancia principal, sigue estos pasos:

   1. En el campo ID de instancia, ingresa my-cluster-primary.

   2. En Disponibilidad zonal, selecciona Zona única.

      Nota: Si bien no recomendamos una instancia de zona única para la producción, puedes usar una zona única en esta guía de inicio rápido para minimizar los costos. Para obtener más información, consulta Reduce los costos con instancias básicas.

   3. En el menú Tipo de máquina, selecciona el tipo de máquina 2 vCPU, 16 GB.

   4. En el menú Red, en Conectividad, selecciona la red default.

      Si ya tienes configurada una conexión de acceso privado a servicios, 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, selecciona Usar un rango de IP asignado automáticamente.

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

   5. Conserva la configuración predeterminada en Seguridad de redes.

5. Haga clic en Crear clúster. AlloyDB puede tardar varios minutos en crear el clúster y mostrarlo en la página Descripción general del clúster principal.

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

Nota: Para conectar un cliente de psql a una instancia, sigue los pasos que se indican en Conéctate desde Compute Engine.

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 Accede a AlloyDB Studio, sigue estos pasos:

   1. Elige un método de autenticación de base de datos.

   2. Selecciona la base de datos postgres.

   3. 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 Accede a 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 de AlloyDB.

   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 la base de datos

1. Sigue los pasos que se indican en Conéctate a la base de datos 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 insertaron 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
   

Realiza una limpieza

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 Borrar el clúster my-cluster, ingresa my-cluster para confirmar que deseas borrar el clúster.

5. Haz clic en Borrar.

6. Opcional: Si creaste una conexión de acceso privado a servicios cuando creaste el clúster y ya no necesitas el rango de direcciones IP asignado, sigue los pasos que se indican en Quita un rango asignado de acceso privado a servicios.

¿Qué sigue?

• Obtén más información sobre otras formas de conectarte a AlloyDB.

• Otorga acceso a otros usuarios.

• Habilita el acceso privado a servicios.

• Elige un tipo de máquina de AlloyDB.

• Crea un clúster de AlloyDB y su instancia principal.

• Obtén más información sobre las recomendaciones de dimensionamiento.

• Conéctate desde Compute Engine.