Conéctate a Cloud SQL para PostgreSQL desde Cloud Shell

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

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

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

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

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

    Go to project selector

  5. Make sure that billing is enabled for your Google Cloud project.

  6. Habilita las APIs de Google Cloud necesarias.

    Console

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

    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

Cree una instancia de Cloud SQL

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

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

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 con zona de pruebas.

  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 consola de Google Cloud, haz clic en el ícono de Cloud Shell (Í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 a acceder a 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 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 la dirección IP pública de tu instancia de Cloud SQL puede tener 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=>

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 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 consola de Google Cloud, ve a la página API.

    Ir a las API

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

¿Qué sigue?