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 guía por el proceso de creación y conexión a tu primera base de datos en AlloyDB para PostgreSQL.

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

Antes de comenzar

Consola

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.

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

Verify that billing is enabled for your Google Cloud project.

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

Verify that billing is enabled for your Google Cloud project.

1. Habilita las API de Cloud necesarias para crear y conectarte a AlloyDB para PostgreSQL.

   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 Google Cloud que AlloyDB.

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

gcloud

1. Crea un Google Cloud proyecto 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 tener habilitada la facturación para tu Google Cloud proyecto. 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 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 Google Cloud diferente, confirma que la API de Compute Engine y la API de Service Networking estén habilitadas en ese proyecto para que puedas configurar la VPC compartida y el acceso privado a los servicios en ese proyecto.

   gcloud services list
   

Crea un clúster y su instancia principal

Nota: Si planeas usar 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 de configuración de redes de Cloud simplificadas.

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 porque la usarás en esta guía de inicio rápido.

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

   4. En el menú desplegable Región de Ubicación, selecciona la región de 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, haz clic en Zona única.

      Nota: Si bien no recomendamos una instancia de una sola zona para la producción, puedes usar una sola zona 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ú desplegable Tipo de máquina, selecciona el tipo de máquina 2 vCPU, 16 GB.

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

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

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

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

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

5. Haga clic en Crear clúster. AlloyDB puede tardar varios minutos en crear el clúster y mostrarlo en la página Overview 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 Accede a AlloyDB Studio, sigue estos pasos:

   1. Elige un método de autenticación de la 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 instrucción en la pestaña Editor 1 y, luego, haz clic en Ejecutar:

   CREATE DATABASE guestbook;
   

   Sabrás que se creó la 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.

   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, se muestra 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 deseas borrar el clúster.

5. Haz clic en Borrar.

6. Si creaste una conexión privada cuando creaste un clúster, ve a la Google Cloud consolapágina Networkingy 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 dimensionamiento