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. Accede a tu cuenta de Google Cloud. 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.
  2. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

  4. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  5. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

  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. Ingresa myinstance en ID de la instancia.
  5. Ingresa una contraseña para el usuario postgres.
  6. Haga clic en Crear.

    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.

  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 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. 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
    
  4. Haz clic en Autorizar en el cuadro de mensaje para autorizar a Cloud Shell a realizar llamadas a la API.

    Un mensaje indica que tu IP se está incluyendo en la lista de anunciantes permitidos para las conexiones entrantes, después de lo cual se te pedirá que ingreses tu contraseña.

  5. 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?