Crea y consulta una base de datos de Cloud SQL para PostgreSQL con la Cloud de Confiance consola

Aprende a crear y consultar una base de datos de Cloud SQL para PostgreSQL con la Cloud de Confiance consola. Este instructivo está dirigido a profesionales de bases de datos que buscan una introducción rápida a Cloud SQL para PostgreSQL. En este instructivo, se explican los pasos necesarios para completar las siguientes tareas:

  • Crea una instancia de Cloud SQL para PostgreSQL
  • Crea una base de datos
  • Crea un esquema
  • Crea una tabla
  • Inserta datos
  • Consulta los datos que insertaste
  • Limpia tus recursos.

A medida que sigas los pasos, mantén los valores predeterminados para la configuración, a menos que se especifique lo contrario.

Antes de comenzar

  1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance 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.

    Go to project selector

  2. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

  3. Verify that billing is enabled for your Cloud de Confiance project.

  4. Enable the Cloud SQL, Cloud SQL Admin, and Compute Engine APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

Roles obligatorios

Para obtener los permisos que necesitas para completar este instructivo, pídele a tu administrador que te otorgue el rol de IAM de administrador de Cloud SQL (roles/cloudsql.admin) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Crea una instancia de Cloud SQL para PostgreSQL

Crea una instancia en la Cloud de Confiance con la siguiente configuración. Para todas las demás opciones de configuración, mantén los valores predeterminados.

  1. Ve a la página Instancias de Cloud SQL en la Cloud de Confiance consola.
    Ir a la página Instancias de Cloud SQL
  2. Haz clic en Crear instancia.
  3. Haz clic en Elegir Cloud SQL para PostgreSQL.
  4. En Elige una edición de Cloud SQL, selecciona Enterprise.
  5. En Ajuste predeterminado de edición, selecciona Zona de pruebas.
  6. En ID de instancia, ingresa quickstart-instance.
  7. Ingresa una contraseña para la cuenta de usuario predeterminada y guárdala para usarla más adelante.
  8. Elige una región cercana.
  9. En Disponibilidad zonal, selecciona Zona única.
  10. Haz clic en Crear instancia y espera hasta que la instancia se inicialice y comience. El proceso de inicialización puede tardar más de cinco minutos.

Crea una base de datos

Después de crear quickstart-instance, puedes crear una base de datos en tu instancia de Cloud SQL para PostgreSQL.

  1. En el menú de navegación de la instancia, haz clic en Bases de datos.
  2. Haz clic en Crear una base de datos.
  3. En el campo de texto Nombre de la base de datos, ingresa quickstartdb.
  4. Haz clic en Crear.

Agregar un usuario

Para leer o escribir en la base de datos, debes crear un usuario de base de datos que sea diferente del usuario raíz.

  1. En el menú de navegación de la instancia, haz clic en Usuarios.
  2. Haz clic en Agregar cuenta de usuario.
  3. En el panel que se abre, selecciona Autenticación integrada.
  4. En el campo Nombre de usuario, ingresa quickstart-user.
  5. Ingresa una contraseña para el usuario nuevo. Guarda esta contraseña para usarla más adelante.
  6. Haz clic en Agregar.

Crea un esquema

Después de crear la instancia y la base de datos, puedes navegar a Cloud SQL Studio y usar el editor de consultas para crear un esquema.

  1. En el menú de navegación de la instancia, haz clic en Cloud SQL Studio. Se mostrará un diálogo.
  2. En el menú desplegable Base de datos, elige quickstartdb.
  3. Selecciona Autenticación de bases de datos integradas.
  4. En el menú desplegable Usuario, selecciona quickstart-user.
  5. En el campo Contraseña, ingresa la contraseña que elegiste para el usuario en la sección Agregar un usuario.
  6. Haz clic en Autenticar. Se abrirá Cloud SQL Studio.
  7. Haz clic en Consulta sin título para abrir el editor de consultas.
  8. Pega el siguiente código en el editor de consultas:

    CREATE SCHEMA IF NOT EXISTS "myschema";
    
  9. Opcional: Para dar formato correcto a la instrucción de SQL, haz clic en Formato.

  10. Haz clic en Ejecutar. En el panel de resultados, se muestra un mensaje de éxito.

Crea una tabla

Ahora crea una tabla con el esquema que creaste.

  1. Haz clic en Nueva pestaña para abrir una nueva pestaña del editor de consultas.
  2. Pega la siguiente instrucción en el editor de consultas:

    CREATE TABLE IF NOT EXISTS
      "myschema"."quickstart_table" ( "UserId" SERIAL
      PRIMARY KEY
        ,
        "FirstName" VARCHAR(255),
        "LastInitial" VARCHAR(1),
        "BirthDate" DATE );
    
  3. Opcional: Para dar formato correcto a la instrucción de SQL, haz clic en Formato.

  4. Haz clic en Ejecutar. En el panel de resultados, se muestra un mensaje de éxito.

La base de datos quickstartdb ahora tiene una tabla con las columnas para almacenar los siguientes datos:

  • Una columna de ID de usuario que se incrementa automáticamente y que está configurada como la clave primaria de la tabla
  • Nombre
  • Inicial del apellido
  • Fecha de nacimiento

Inserta datos

Para propagar la tabla quickstart_table con algunos datos, sigue estos pasos:

  1. Haz clic en Nueva pestaña para abrir una nueva pestaña del editor de consultas.
  2. Pega la siguiente instrucción en el editor de consultas:

    INSERT INTO
      "myschema"."quickstart_table" ("FirstName",
        "LastInitial",
        "BirthDate")
    VALUES
      ('Yuri', 'Z', '1999-05-24'),
      ('Cruz', 'S', '1978-11-01'),
      ('Kai', 'D', '1965-12-09'),
      ('Luka', 'L', '2003-04-19'),
      ('Taylor', 'S', '2001-01-31');
    
  3. Opcional: Para dar formato correcto a la instrucción de SQL, haz clic en Formato.

  4. Haz clic en Ejecutar. En el panel de resultados, se muestra un mensaje de éxito.

Consulta la base de datos

Ahora puedes ejecutar consultas en los datos de la tabla que creaste.

Selecciona todos los registros

Para recuperar todos los registros de la tabla, haz lo siguiente:

  1. Haz clic en Nueva pestaña para abrir una nueva pestaña del editor de consultas.

  2. Pega la siguiente instrucción en el editor de consultas:

    SELECT
      *
    FROM
      "myschema"."quickstart_table"
    
  3. Haz clic en Ejecutar.

    Los resultados de la consulta son similares a los siguientes:

    UserID

    FirstName

    LastInitial

    BirthDate

    1

    Yuri

    Z

    1999-05-24 00:00:00

    2

    Cruz

    S

    1978-11-01 00:00:00

    3

    Kai

    D

    1965-12-09 00:00:00

    4

    Luka

    L

    2003-04-19 00:00:00

    5

    Taylor

    S

    2001-01-31 00:00:00

Ejecuta una instrucción select filtrada

Para recuperar el ID de usuario y el nombre de los usuarios nacidos el 1 de enero de 2000 o después, especifica las columnas y usa una cláusula WHERE:

  1. Haz clic en Nueva pestaña para abrir una nueva pestaña del editor de consultas.
  2. Pega la siguiente instrucción en el editor de consultas:

    SELECT
      "UserId",
      "FirstName"
    FROM
      "myschema"."quickstart_table"
    WHERE
      "BirthDate" > '1999-12-31';
    
  3. Haz clic en Ejecutar.

    Los resultados de la consulta son similares a los siguientes:

    UserID

    FirstName

    4

    Luka

    5

    Taylor

Limpia

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

Inhabilita la protección contra eliminaciones y, luego, borra la instancia de inicio rápido:

  1. En el menú de navegación de la instancia, haz clic en Descripción general.
  2. Haz clic en Editar.
  3. Expande la sección Protección de datos.
  4. En Protección contra eliminación de instancias, anula la selección de todas las opciones.
  5. Haz clic en Guardar. Borrar ahora se puede seleccionar.
  6. Haz clic en Borrar. Aparecerá un diálogo.
  7. En el campo ID de instancia, ingresa quickstart-instance.
  8. Haz clic en Borrar.

¿Qué sigue?