Conéctate a Cloud SQL para PostgreSQL desde Cloud Shell

Conéctate a Cloud SQL para PostgreSQL desde Cloud Shell

MySQL   |  PostgreSQL   |  SQL Server

En esta página, se muestra cómo crear una instancia de PostgreSQL y conectarse a ella, y cómo realizar operaciones básicas de SQL mediante la Google Cloud consola de Google Cloud y un cliente. Los recursos creados en esta guía de inicio rápido suelen costar menos de un dólar, bajo la suposición de que completas los pasos, incluida la limpieza, de manera correcta.

Antes de comenzar

Nota: El nombre que uses para el proyecto debe tener entre 4 y 30 caracteres. Cuando escribes el nombre, el formulario sugiere un ID del proyecto que puedes editar. El ID del proyecto debe tener entre 6 y 30 caracteres y debe comenzar con una letra minúscula. Puedes usar un guion, una letra minúscula o un número para los caracteres restantes, pero el último carácter no puede ser un guion.

Accede a tu Google Cloud cuenta de. 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

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

Verify that billing is enabled for your Google Cloud project.

1. Habilita las APIs de Google Cloud necesarias.

   Console

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

   Ir a las API

   Habilita la API de Cloud SQL Admin

   gcloud

   Haz clic en el siguiente botón para abrir Cloud Shell, que proporciona acceso de línea de comandos a tus Google Cloud recursos directamente desde el navegador. Cloud Shell se puede usar para ejecutar los comandos de gcloud que se presentan en esta guía de inicio rápido.

   Abra Cloud Shell

   Ejecuta el comando gcloud services enable de la siguiente manera con Cloud Shell a fin de habilitar las API necesarias para esta guía de inicio rápido:

   gcloud services enable sqladmin.googleapis.com

   Este comando habilita las siguientes API:

   • API de Cloud SQL Admin

2. Asegúrate de tener los siguientes roles en el proyecto: Administrador de Cloud SQL (roles/cloudsql.admin)

   Verifica los roles

   1. En la Google Cloud consola de, dirígete a la página IAM.

      Ir a IAM
   2. Selecciona el proyecto.

   3. En la columna Principal, busca todas las filas que te identifiquen a ti o a un grupo en el que estés incluido. Para saber en qué grupos estás incluido, comunícate con tu administrador.

   4. Para todas las filas que te especifican o incluyen, verifica la columna Rol para ver si la lista de roles incluye los roles requeridos.

   Otorga los roles

   1. En la Google Cloud consola de, dirígete a la página IAM.

      Ir a IAM
   2. Selecciona el proyecto.
   3. Haz clic en Grant access.

   4. En el campo Principales nuevas, ingresa tu identificador de usuario. Esta suele ser la dirección de correo electrónico de una Cuenta de Google.

   5. Haz clic en Seleccionar un rol y, luego, busca el rol.
   6. Para otorgar roles adicionales, haz clic en Agregar otro rol y agrega uno más.
   7. Haz clic en Guardar.

Cree una instancia de Cloud SQL

En esta guía de inicio rápido, usas la Google Cloud consola de Google Cloud. Para usar el gcloud CLI, cURL o PowerShell, consulta la documentación sobre cómo crear instancias.

1. En la Google Cloud consola de, ve a la página Instancias de Cloud SQL.

   Ir a Instancias de Cloud SQL

2. Haga clic en Crear instancia.
3. Haz clic en Elegir PostgreSQL.
4. En el campo ID de instancia, ingresa myinstance.
5. En el campo Contraseña, ingresa una contraseña para el usuario postgres.

6. Haga clic en Crear instancia.

   Volverás a la lista de las instancias. Puedes hacer clic en la instancia nueva de inmediato para ver los detalles, pero no estará disponible para otras operaciones hasta que se inicialice y se inicie.

   Nota: En este ejemplo, la instancia se crea con la configuración predeterminada, incluida una dirección IP pública.

Conéctese a su instancia

En esta guía de inicio rápido, usaremos el cliente psql en Cloud Shell para conectarnos a la instancia. Cloud Shell es un entorno remoto en un espacio aislado.

Nota: Cloud Shell no funciona con una dirección IP privada. Estas instrucciones son solo para una instancia con una dirección IP pública.

1. Opcional: Si ejecutas una instancia local de PostgreSQL, detenla antes de conectarte a tu instancia de Cloud SQL. De lo contrario, es posible que veas errores como address already in use.

2. En la Google Cloud consola, haz clic en el ícono de Cloud Shell () en la esquina superior derecha.

   Cuando Cloud Shell termine de inicializarse, aparecerá un mensaje como el que se muestra a continuación:

   Welcome to Cloud Shell! Type "help" to get started.
   Your Cloud Platform project in this session is set to sample-project.
   Use "gcloud config set project [PROJECT_ID]" to change to a different project.
   username@sample-project:~ (sample-project)$
   

3. Opcional: Si no autorizaste a gcloud CLI para acceder a la Google Cloud plataforma con tus credenciales de usuario de Google, usa el comando gcloud auth login.

4. En la ventana de Cloud Shell, conéctate a tu instancia de Cloud SQL. Usa el gcloud sql connect de la siguiente manera. Reemplaza el nombre de la instancia si el nombre de tu instancia es diferente.

   gcloud sql connect myinstance --user=postgres

5. En el cuadro de diálogo, haz clic en Autorizar para autorizar a Cloud Shell a realizar llamadas a la API.

   Aparecerá el siguiente mensaje:

   Allowlisting your IP for incoming connection for 5 minutes...done.
   

   Este mensaje indica que se permite que la dirección IP pública de tu instancia de Cloud SQL tenga conexiones entrantes. Después de este mensaje, se te solicitará que ingreses tu contraseña.

6. Ingresa tu contraseña de postgres.

   Aparecerá el cuadro de psql.

Crea una base de datos y sube datos

1. Crea una base de datos de SQL en tu instancia de Cloud SQL:

   CREATE DATABASE guestbook;

2. Para conectarte a la base de datos, ingresa el siguiente comando y especifica la contraseña.

   \connect guestbook;

3. Inserta datos de muestra en la base de datos:

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

4. Recupera los datos:

   SELECT * FROM entries;

   El resultado es:

     guestname   |   content   | entryid
   --------------+-------------+---------
    first guest  | I got here! |       1
    second guest | Me too!     |       2
   (2 rows)
   postgres=>
   

Limpia

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

1. En la Google Cloud consola de, ve a la página Instancias de Cloud SQL.

   Ir a Instancias de Cloud SQL

2. Selecciona la instancia myinstance para abrir la página de detalles de la instancia.
3. En la barra de íconos en la parte superior de la página, haz clic en Borrar.
4. En la ventana Borrar instancia, escribe el nombre de tu instancia y, luego, haz clic en Borrar.

Pasos opcionales de limpieza

Si no usas las API que se habilitaron como parte de esta guía de inicio rápido, puedes inhabilitarlas.

• API que se habilitaron en esta guía de inicio rápido:
  • API de Cloud SQL Admin

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

   Ir a las API

2. Selecciona la API de Cloud SQL Admin y, luego, haz clic en el botón Inhabilitar API.

¿Qué sigue?

• Obtén más información sobre cómo crear instancias de Cloud SQL.

• Aprende a crear usuarios de PostgreSQL y bases de datos para tu instancia de Cloud SQL.

• Consulta la información de precios de Cloud SQL.

• En esta guía de inicio rápido, te conectaste a la instancia mediante Cloud Shell. Obtén más información sobre todas las opciones de conectividad de Cloud SQL. La forma en que te conectas depende de tu configuración de red, por ejemplo, si tu instancia de Cloud SQL tiene una dirección IP pública o privada. Consulta cómo configurar tu instancia de Cloud SQL con una IP pública y una dirección IP privada.

• Obtén información sobre cómo conectarte a una instancia de Cloud SQL desde otras aplicaciones de Google Cloud:

  • Desde una aplicación que se ejecuta en el entorno estándar de App Engine
  • Desde una aplicación que se ejecuta en Compute Engine
  • Desde una aplicación que se ejecuta en GKE
  • Desde Cloud Run