Escribir SQL con la asistencia de Gemini

En este documento se describe cómo puedes usar Gemini, un colaborador basado en IA enGoogle Cloud, para hacer lo siguiente en Cloud SQL Studio:

Consulta cómo y cuándo Gemini Google Cloud usa tus datos.

Este documento está dirigido a administradores de bases de datos e ingenieros de datos que estén familiarizados con SQL, el análisis de datos y Cloud SQL. Si no has usado Cloud SQL antes, consulta el resumen de Cloud SQL.

Antes de empezar

  1. Para completar las tareas de este documento, asegúrate de tener los permisos de gestión de identidades y accesos (IAM) necesarios.
  2. Confirma el acceso a Cloud SQL Studio. Si no tienes acceso a Cloud SQL Studio, consulta los roles y permisos necesarios de Cloud SQL Studio.

  3. Opcional: Para seguir los ejemplos de este documento, crea una tabla de Singers con el siguiente esquema:

    CREATE TABLE
Singers (
  SingerId   BIGINT PRIMARY KEY,
  FirstName  VARCHAR(1024),
  LastName   VARCHAR(1024),
  SingerInfo VARBINARY(MAX),
  BirthDate  DATETIMEOFFSET
);

    Después de crear la tabla Singers, haz clic en Actualizar para actualizar el esquema de la base de datos.

Roles y permisos necesarios

Para obtener los permisos que necesitas para completar las tareas de este documento, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de Cloud SQL (roles/cloudsql.admin) en el proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

También necesitas el permiso cloudaicompanion.companions.generateChat para usar explicar instrucciones SQL en el editor de consultas y cloudaicompanion.companions.generateCode para usar Ayúdame a escribir código.

Generar consultas de SQL con peticiones en lenguaje natural

Puedes dar comentarios en lenguaje natural (o peticiones) a Gemini para generar consultas basadas en tu esquema. Por ejemplo, puedes pedirle a Gemini que genere SQL en respuesta a las siguientes peticiones:

  • "Crea una tabla que registre los resultados de la encuesta de satisfacción de los clientes".
  • "Añade una columna de fecha llamada cumpleaños a la tabla Cantantes".
  • "¿Cuántos cantantes nacieron en los 90?"

Si tu esquema cambia (por ejemplo, si se añade una tabla o una columna), haz clic en ActualizarActualizar para actualizarlo antes de usar Gemini.

Para generar SQL en Cloud SQL con la asistencia de Gemini, sigue estos pasos:

  1. En la Google Cloud consola, ve a la página Cloud SQL.

    Ir a Cloud SQL

  2. Selecciona una instancia de la lista.

  3. En el menú de navegación, haz clic en Cloud SQL Studio.

  4. Inicia sesión en Cloud SQL Studio con el nombre de tu base de datos, el nombre de usuario y la contraseña. En el panel Explorador se muestra una lista de los objetos de la base de datos.

  5. En la barra de tareas, haz clic en pen_sparkGemini para ver las funciones de Gemini en Cloud SQL.

  6. Comprueba que la opción Generación de consultas a partir de comentarios esté habilitada.

  7. Para consultar tu base de datos, haz clic en Nueva pestaña del editor de SQL.

  8. Para generar SQL, escribe un comentario en el editor de consultas que empiece por -- seguido de un comentario de una sola línea y, a continuación, pulsa Intro.

    Por ejemplo, introduce la siguiente petición:

    -- add a row to table singers

    Pulsa Intro o Retorno. Gemini genera un SQL similar al siguiente:

    INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate)
VALUES (1, 'Alex', 'M.', '1977-10-16');

    Para continuar con el ejemplo usando la tabla Singers, introduce la siguiente petición:

    -- show all singers born in the 70s

    Gemini genera SQL similar al siguiente:

    SELECT *
FROM Singers
WHERE Singers.BirthDate
BETWEEN '1970-01-01' AND '1979-12-31'

  9. Revisa la sugerencia de SQL y lleva a cabo alguna de las siguientes acciones:

    • Para ver las opciones para aceptar el SQL generado por Gemini, coloca el puntero sobre la consulta. Se mostrarán las siguientes opciones:
      • Aceptar: para aceptar la consulta sugerida, pulsa Tab y, a continuación, haz clic en Ejecutar.
      • Aceptar palabra: para aceptar parcialmente la consulta sugerida, pulsa Control+Right arrow (o Command+Right arrow en macOS) y, a continuación, haz clic en Ejecutar.
    • Para editar el SQL original, pulsa Tab, edita el SQL y, a continuación, haz clic en Ejecutar.
    • Para descartar la sugerencia, pulsa Esc o sigue escribiendo.

Herramienta Ayúdame a programar

Para usar la herramienta Ayúdame a escribir código, sigue estos pasos:

  1. En la Google Cloud consola, ve a la página Cloud SQL.

    Ir a Cloud SQL

  2. Selecciona una instancia de la lista.

  3. En el menú de navegación, haz clic en Cloud SQL Studio.

  4. Inicia sesión en Cloud SQL Studio con el nombre de tu base de datos, el nombre de usuario y la contraseña. En el panel Explorador se muestra una lista de los objetos de la base de datos.

  5. Para consultar tu base de datos, haz clic en la nueva pestaña.

  6. Haz clic en pen_spark Ayúdame a escribir código junto al editor de consultas.

  7. En la ventana Ayúdame a programar, introduce una petición. Por ejemplo, add a row to table singers y haz clic en Generar.

    Gemini genera un código SQL similar al siguiente:

    INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate)
VALUES (1, Alex, 'M.', '1977-10-16');

  8. Revisa el código SQL generado y haz lo siguiente:

    • Para aceptar el código SQL generado por Gemini, haz clic en Insertar para insertar la instrucción en el editor de consultas. A continuación, haz clic en Ejecutar para ejecutar el SQL sugerido.
    • Para pedirle a Gemini que genere una nueva consulta, haz clic en Editar. Cuando hayas editado la petición, haz clic en Actualizar. Después, puedes aceptar la nueva declaración generada o rechazar la sugerencia.
    • Para descartar la sugerencia, cierra la ventana Ayúdame a escribir código.

Explicar las instrucciones SQL en el editor de consultas

Puedes usar Gemini en Cloud SQL para explicar consultas de SQL en lenguaje natural. Esta explicación puede ayudarte a entender la sintaxis, el esquema subyacente y el contexto empresarial de las consultas complejas o largas.

  1. En la Google Cloud consola, ve a la página Cloud SQL.

    Ir a Cloud SQL

  2. Selecciona una instancia de la lista.

  3. En el menú de navegación, haz clic en Cloud SQL Studio.

  4. Inicia sesión en Cloud SQL Studio con el nombre de tu base de datos, el nombre de usuario y la contraseña. En el panel Explorador se muestra una lista de los objetos de la base de datos.

  5. Para consultar tu base de datos, haz clic en la nueva pestaña.

  6. En el editor de consultas, pega la consulta que quieras que se explique.

  7. Destaca la consulta que quieras que Gemini explique y, a continuación, haz clic en chispa Explicar esta consulta.

    La explicación de la consulta de SQL aparece en la ventana Chat de Gemini.

Siguientes pasos