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

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

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

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

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

   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.

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 consola de Google Cloud, 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. 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?

• 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 funciones de Cloud Run
  • Desde Cloud Run