Crear una base de datos y conectarse a ella

Crear una base de datos y conectarse a ella

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

Al final de esta guía de inicio rápido se incluyen instrucciones para limpiar esta nueva base de datos. La página termina con los pasos siguientes para obtener más información sobre cómo usar AlloyDB con tus propias aplicaciones.

Antes de empezar

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.

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 (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

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.

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 (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

Verify that billing is enabled for your Google Cloud project.

1. Habilita las APIs de Cloud necesarias para crear una instancia de AlloyDB para PostgreSQL y conectarte a ella.

   Habilitar las APIs

   1. En el paso Confirmar proyecto, haz clic en Siguiente para confirmar el nombre del proyecto que vas a modificar.

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

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

      La API Service Networking es necesaria si tienes previsto configurar la conectividad de red a AlloyDB mediante una red de VPC que se encuentre en el mismo Google Cloud proyecto que AlloyDB.

      Las APIs Compute Engine y Cloud Resource Manager son necesarias si tienes previsto configurar la conectividad de red a AlloyDB mediante una red VPC que se encuentre en otro Google Cloud proyecto.

gcloud

1. Crea un Google Cloud proyecto o usa uno que ya tengas:

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

   Haz los cambios siguientes:

   • PROJECT_ID: identificador permanente del proyecto.

2. Comprueba que la facturación esté habilitada en tu Google Cloud proyecto. Consulta cómo confirmar que la facturación está habilitada en tu proyecto.

3. Habilita las APIs 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 tienes previsto configurar la conectividad de red a AlloyDB mediante una red de VPC que se encuentre en el mismo proyecto Google Cloud que AlloyDB, habilita la API Service Networking en el proyecto.

   gcloud services enable servicenetworking.googleapis.com
   

5. Si tienes previsto configurar la conectividad de red a AlloyDB mediante una red VPC que se encuentre en otro proyecto, comprueba que las APIs Compute Engine y Service Networking estén habilitadas en ese proyecto para que puedas configurar la VPC compartida y el acceso a servicios privados en él. Google Cloud

   gcloud services list
   

Crear un clúster y su instancia principal

Nota: Si tienes previsto usar redes privadas, puedes implementar la configuración de redes privadas que elijas y la instancia de AlloyDB junto con clientes como las VMs de Compute Engine mediante Terraform. Para obtener más información, consulta las soluciones de configuración de redes en la nube simplificadas

.

1. En la Google Cloud consola, ve a la página Clusters.

   Ir a Clústeres

2. Haz clic en Crear clúster.

3. En Configurar el clúster, sigue estos pasos:

   1. En el campo ID de clúster, introduce my-cluster.

   2. Introduce una contraseña. Anota 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ú desplegable Región de Ubicación, selecciona la región us-central1 (Iowa).

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

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

   2. En Disponibilidad zonal, haz clic en Una sola zona.

      Nota: Aunque no recomendamos usar una instancia de una sola zona en producción, puedes usar una sola zona en esta guía de inicio rápido para minimizar los costes. Para obtener más información, consulta Reducir costes 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, ve al paso para crear un clúster. De lo contrario, haz clic en Configurar conexión y sigue estos pasos:

      1. En Asignar intervalo de IP, haz clic en Usar intervalo de IP asignado automáticamente.

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

   5. Mantenga los ajustes predeterminados en Seguridad de red.

5. Haz clic en Crear clúster. AlloyDB puede tardar varios minutos en crear el clúster y mostrarlo en la página Resumen del clúster principal.

Conectarse a la instancia y crear una base de datos

1. En la Google Cloud consola, ve a la página Clusters.

   Ir a Clústeres

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

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

4. En la página Iniciar sesión en 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, introduce la siguiente instrucción en la pestaña Editor 1 y, a continuación, haz clic en Ejecutar:

   CREATE DATABASE guestbook;
   

   Sabrás que la base de datos se ha creado cuando aparezca el Statement executed successfully mensaje en el panel Resultados.

Conectarse a la base de datos guestbook

1. En la Google Cloud consola, ve a la página Clusters.

   Ir a Clústeres

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

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

4. En la página Iniciar sesión en AlloyDB Studio, sigue estos pasos:

   1. Selecciona la base de datos guestbook.

   2. Selecciona el usuario postgres.

   3. Introduce la contraseña que has creado en Crear 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.

Verificar la conexión de la base de datos

1. Sigue los pasos que se indican en Conectarse a la base de datos guestbook.

2. Para insertar datos de muestra en la base de datos guestbook, introduce 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 del panel Resultados indica que los datos se han insertado en la 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, introduce 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
   

Limpieza

Para evitar que se apliquen cargos en tu cuenta de Google Cloud por los recursos utilizados en esta página, sigue estos pasos.

1. En la Google Cloud consola, ve a la página Clusters.

   Ir a Clústeres

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

3. Haz clic en Eliminar clúster.

4. En Eliminar clúster my-cluster, introduce my-cluster para confirmar que quieres eliminar el clúster.

5. Haz clic en Eliminar.

6. Si has creado una conexión privada al crear un clúster, ve a la página Redes de la consola Google Cloud y haz clic en Eliminar red de VPC.

Siguientes pasos

• Habilitar el acceso del proyecto a AlloyDB

• Conceder acceso a otros usuarios

• Habilitar el acceso privado a servicios

• Crear un clúster y su instancia principal

• Información sobre las recomendaciones de tamaño