Escribe SQL con la ayuda de Gemini

En este documento, se describe cómo puedes usar Gemini, un colaborador impulsado por IA en Google Cloud, para ayudarte a hacer lo siguiente en Cloud SQL:

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

Este documento está dirigido a ingenieros y administradores de datos que estén familiarizados con SQL, análisis de datos y Cloud SQL. Si es la primera vez que usas Cloud SQL, consulta la Descripción general de Cloud SQL.

Antes de comenzar

  1. Asegúrate de haber configurado Gemini en bases de datos.
  2. Para completar las tareas de este documento, asegúrate de tener los permisos necesarios de administración de identidades y accesos (IAM).
  3. Confirmar el acceso a Cloud SQL Studio. Si no tienes acceso a Cloud SQL Studio, consulta Roles y permisos necesarios de Cloud SQL Studio.
  4. Para seguir los ejemplos de este documento, crea una tabla Singers (opcional) con el siguiente esquema:

    CREATE TABLE
    Singers (
      SingerId   BIGINT PRIMARY KEY,
      FirstName  VARCHAR(1024),
      LastName   VARCHAR(1024),
      SingerInfo MEDIUMBLOB,
      BirthDate  DATETIME
    );
    

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

Roles y permisos requeridos

Para obtener los permisos que necesitas para completar las tareas de este documento, 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 mediante roles personalizados o cualquier otro rol predefinido.

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

Genera consultas en SQL con instrucciones escritas en lenguaje natural

Puedes escribirle comentarios en lenguaje natural a Gemini (o instrucciones) para generar consultas basadas en tu esquema. Por ejemplo, puedes pedirle a Gemini que genere SQL al responder los siguientes mensajes:

  • “Crea una tabla que haga un seguimiento de los resultados de la encuesta de satisfacción del cliente”.
  • "Agrega una columna de fecha llamada cumpleaños a la tabla Singers".
  • "¿Cuántos cantantes nacieron en los 90?"

Si tu esquema cambia, como la adición de una tabla o columna nueva, haz clic en actualizarActualizar para actualizar tu esquema antes de usar Gemini.

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

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

    Ir a Cloud SQL

  2. Elige una instancia de la lista.

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

  4. Accede a Cloud SQL con el nombre de tu base de datos, así como tu nombre de usuario y contraseña. El panel Explorador muestra una lista de objetos en tu base de datos.

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

  6. Asegúrate de que la Generación de comentarios a las consultas esté habilitada.

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

  8. Para generar SQL, escribe un comentario en el editor de consultas a partir de -- seguido de uncomentario de una línea y luego presionaRetorno oIntro.

    Por ejemplo, ingresa la siguiente instrucción:

    -- add a row to table singers
    

    Presiona Retorno o Intro. Gemini genera un SQL que es similar al siguiente:

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

    Para continuar con el ejemplo con la tabla Singers, ingresa el siguiente mensaje:

    -- show all singers born in the 70s
    

    Gemini genera un SQL similar a lo siguiente:

    SELECT *
    FROM Singers
    WHERE Singers.BirthDate
    BETWEEN '1970-01-01' AND '1979-12-31'
    
    
  9. Revisa la sugerencia de SQL y realiza cualquiera de las siguientes acciones:

    • Para ver las opciones para aceptar el SQL que genera Gemini, mantén el puntero sobre la consulta. Se muestran las siguientes opciones:
      • Aceptar: Para aceptar la consulta sugerida, presiona Tab y, luego, haz clic en Ejecutar.
      • Aceptar palabra: Para aceptar la consulta sugerida de forma parcial, presiona Control+Right arrow (o Command+Right arrow en macOS) y, luego, haz clic en Ejecutar.
    • Para editar el SQL original, presiona Tab, edita el SQL y, luego, haz clic en Ejecutar.
    • Para descartar una sugerencia, presiona EscEsc o continúa escribiendo.

Herramienta Help me code

Para usar la herramienta Help me code, sigue estos pasos:

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

    Ir a Cloud SQL

  2. Elige una instancia de la lista.

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

  4. Accede a Cloud SQL con el nombre de tu base de datos, así como tu nombre de usuario y contraseña. El panel Explorador muestra una lista de objetos en tu base de datos.

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

  6. Haz clic en pen_spark Help me code junto al editor de consultas.

  7. En la ventana Help me code, ingresa una instrucción. Por ejemplo, add a row to table singers y haz clic en Generar.

    Gemini genera un SQL similar a lo siguiente:

    INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate)
    VALUES (1, Alex, 'M.', '1977-10-16');
    
  8. Revisa la consulta en SQL generada y realiza cualquiera de las siguientes acciones:

    • Para aceptar el SQL que genera Gemini, haz clic en Insertar para insertar la declaración en el editor de consultas. Luego, haz clic en Ejecutar para ejecutar el SQL sugerido.
    • Para pedirle a Gemini que genere una consulta nueva, haz clic en Editar. Después de editar el mensaje, haz clic en Actualizar. Luego, puedes decidir aceptar la nueva declaración generada o descartar la sugerencia.
    • Para descartar la sugerencia, cierra la ventana Help me code.

Completa instrucciones de SQL en el editor de consultas

Para ayudarte a escribir código SQL, Gemini en Cloud SQL proporciona sugerencias de finalización de código asistidas por IA. Cuando ingresas texto en el editor de consultas de Cloud SQL Studio con Gemini habilitado, Gemini predice y autocompleta el código SQL.

Para usar sugerencias de código intercalado, sigue estos pasos:

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

    Ir a Cloud SQL

  2. Elige una instancia de la lista.

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

  4. Accede a Cloud SQL con el nombre de tu base de datos, así como tu nombre de usuario y contraseña. El panel Explorador muestra una lista de objetos en tu base de datos.

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

  6. Selecciona Finalización de SQL.

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

  8. Ingresa una consulta y un espacio o salto de línea al final de la línea. A medida que ingresas texto, Gemini muestra el SQL sugerido, el cual se basa en los objetos que admite el esquema de la base de datos seleccionada.

    Por ejemplo, para agregar una fila a la tabla Singers, empieza a escribir la siguiente consulta:

    INSERT INTO Singers
    

    Gemini sugiere un SQL similar a lo siguiente:

    INSERT INTO Singers
    (SingerId, FirstName, LastName, BirthDate)
    VALUES
      (1, 'Marc', 'Singer', '1970-03-24')
    
  9. Revisa la sugerencia de SQL y realiza cualquiera de las siguientes acciones:

    • Para ver las opciones para aceptar el SQL que genera Gemini, mantén el puntero sobre la consulta. Se muestran las siguientes opciones:
      • Aceptar: Para aceptar la consulta sugerida, presiona Tab y, luego, haz clic en Ejecutar.
      • Aceptar palabra: Para aceptar la consulta sugerida de forma parcial, presiona Control+Right arrow (o Command+Right arrow en macOS) y, luego, haz clic en Ejecutar.
    • Para editar el SQL original, presiona Tab, edita el SQL y, luego, haz clic en Ejecutar.
    • Para descartar una sugerencia, presiona EscEsc o continúa escribiendo.

Explica instrucciones de SQL en el editor de consultas

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

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

    Ir a Cloud SQL

  2. Elige una instancia de la lista.

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

  4. Accede a Cloud SQL con el nombre de tu base de datos, así como tu nombre de usuario y contraseña. El panel Explorador muestra una lista de objetos en tu 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 para la que desees una explicación.

  7. Destaca la consulta que quieres que Gemini te explique y haz clic en spark Explica esta consulta.

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

¿Qué sigue?