Escriba SQL con la ayuda de Gemini

Este documento describe cómo puedes usar Gemini , un colaborador impulsado por IA enGoogle Cloud, para ayudarle a hacer lo siguiente en Cloud SQL Studio:

Descubre cómo y cuándo Géminis te acompaña Google Cloud utiliza sus datos

Este documento está dirigido a administradores de bases de datos e ingenieros de datos familiarizados con SQL, análisis de datos y Cloud SQL. Si no conoce Cloud SQL, consulte la descripción general de Cloud SQL .

Antes de empezar

  1. Para completar las tareas de este documento, asegúrese de tener los permisos de Administración de identidad y acceso (IAM) necesarios .
  2. Confirme el acceso a Cloud SQL Studio. Si no tiene acceso a Cloud SQL Studio, consulte los roles y permisos necesarios de Cloud SQL Studio.

  3. Opcional: Para seguir los ejemplos de este documento, cree una tabla Singers utilizando 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 , haga clic en Actualizar para actualizar el esquema de su base de datos.

Roles y permisos necesarios

Para obtener los permisos necesarios para completar las tareas de este documento, solicite a su administrador que le 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, consulte Administrar el acceso a proyectos, carpetas y organizaciones .

También es posible que puedas obtener los permisos necesarios a través de roles personalizados u otros roles predefinidos .

También necesita el permiso cloudaicompanion.companions.generateChat para usar declaraciones SQL de explicación en el editor de consultas y cloudaicompanion.companions.generateCode para usar el código de ayuda .

Generar consultas SQL utilizando indicaciones en lenguaje natural

Puede proporcionar comentarios (o indicaciones ) en lenguaje natural a Gemini para generar consultas basadas en su esquema. Por ejemplo, puede indicarle a Gemini que genere SQL en respuesta a las siguientes indicaciones:

  • "Cree 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 Cantantes".
  • ¿Cuántos cantantes nacieron en los años 90?

Si su esquema cambia, como por ejemplo si agrega una nueva tabla o columna, haga clic en Actualizar para actualizar su esquema antes de usar Gemini.

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

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

    Ir a Cloud SQL

  2. Seleccione una instancia de la lista.

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

  4. Inicie sesión en Cloud SQL Studio con el nombre de su base de datos, su nombre de usuario y su contraseña. El panel Explorador muestra una lista de objetos en su base de datos.

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

  6. Asegúrese de que la generación de comentarios a consultas esté habilitada.

  7. Para consultar su base de datos, haga clic en nueva pestaña del editor SQL .

  8. Para generar SQL, escriba un comentario en el editor de consultas comenzando con -- seguido de un comentario de una sola línea y luego presione Retorno o Enter .

    Por ejemplo, introduzca el siguiente mensaje:

    -- add a row to table singers

    Presione Retorno o Enter . Gemini genera un código SQL similar al siguiente:

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

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

    -- 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. Revise la sugerencia de SQL y realice cualquiera de las siguientes acciones:

    • Para ver las opciones para aceptar el SQL generado por Gemini, coloque el cursor sobre la consulta. Se muestran las siguientes opciones:
      • Aceptar : para aceptar la consulta sugerida, presione Tab y luego haga clic en Ejecutar .
      • Aceptar palabra : para aceptar parcialmente la consulta sugerida, presione Control + Right arrow (o Command + Right arrow en macOS), luego haga clic en Ejecutar .
    • Para editar el SQL original, presione Tab , edite el SQL y luego haga clic en Ejecutar .
    • Para descartar la sugerencia, presione Esc o continúe escribiendo.

Herramienta de ayuda para codificar

Para utilizar la herramienta Ayúdame a codificar , sigue estos pasos:

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

    Ir a Cloud SQL

  2. Seleccione una instancia de la lista.

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

  4. Inicie sesión en Cloud SQL Studio con el nombre de su base de datos, su nombre de usuario y su contraseña. El panel Explorador muestra una lista de objetos en su base de datos.

  5. Para consultar su base de datos, haga clic en la pestaña nueva .

  6. Haga clic en pen_spark Ayúdame a codificar junto al editor de consultas.

  7. En la ventana "Ayuda con el código" , introduzca una solicitud. Por ejemplo, add a row to table singers y haga clic en "Generar" .

    Gemini genera SQL similar al siguiente:

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

  8. Revise el SQL generado y realice cualquiera de las siguientes acciones:

    • Para aceptar el SQL generado por Gemini, haga clic en Insertar para insertar la sentencia en el editor de consultas. Luego, haga clic en Ejecutar para ejecutar el SQL sugerido.
    • Para solicitar a Gemini que genere una nueva consulta, haga clic en Editar . Después de editar la solicitud, haga clic en Actualizar . Puede aceptar la nueva declaración generada o descartar la sugerencia.
    • Para descartar la sugerencia, cierre la ventana Ayúdame a obtener el código .

Explicar las sentencias SQL en el editor de consultas

Puedes usar Gemini en Cloud SQL para explicar consultas SQL en lenguaje natural. Esta explicación te ayudará a comprender la sintaxis, el esquema subyacente y el contexto empresarial de consultas complejas o extensas.

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

    Ir a Cloud SQL

  2. Seleccione una instancia de la lista.

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

  4. Inicie sesión en Cloud SQL Studio con el nombre de su base de datos, su nombre de usuario y su contraseña. El panel Explorador muestra una lista de objetos en su base de datos.

  5. Para consultar su base de datos, haga clic en la pestaña nueva .

  6. En el editor de consultas, pegue la consulta que desea explicar.

  7. Resalte la consulta que desea que Gemini explique y luego haga clic en Explicar esta consulta .

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

¿Qué sigue?