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 con la Google Cloud consola 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.

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

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

Make sure 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 recursos de Google Cloud 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. Make sure that you have the following role or roles on the project: Cloud SQL Admin (roles/cloudsql.admin), Cloud SQL Viewer (roles/cloudsql.viewer)

   Check for the roles

   1. In the Google Cloud console, go to the IAM page.

      Go to IAM
   2. Select the project.

   3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

   4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

   Grant the roles

   1. In the Google Cloud console, go to the IAM page.

      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. En la lista Seleccionar un rol, elige un rol.
   6. Para otorgar funciones adicionales, haz clic en Agregar otro rol y agrega cada rol adicional.
   7. Haz clic en Guardar.

Cree una instancia de Cloud SQL

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

1. En la Google Cloud consola, 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. Haz 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 zona de pruebas.

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

   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 Platform 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 comando 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 diálogo, haz clic en Autorizar para autorizar a Cloud Shell a realizar llamadas a la API.

   Aparece 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 pedirá 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 cuenta de Google Cloud por los recursos que usaste en esta página.

1. En la Google Cloud consola, 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