Escribe SQL con la ayuda de Gemini

En este documento, se describe cómo puedes usar Gemini en bases de datos para obtener asistencia potenciada por IA con lo siguiente en Spanner:

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 Spanner, SQL y análisis de datos. Si es la primera vez que usas Spanner, consulta Crea y consulta una base de datos con la consola de Google Cloud.

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. En la consola de Google Cloud, ve a la página Spanner.

    Ir a Spanner

  4. Elige una instancia de la lista.

  5. Selecciona una base de datos.

  6. En el menú de navegación, haz clic en Spanner Studio.

  7. En la barra de tareas, haz clic en pen_spark. Gemini para ver las funciones de Gemini en Spanner

  8. Selecciona las funciones de Gemini que deseas habilitar, por ejemplo, Finalización de SQL y Generación de consulta a partir de comentarios. Puedes seleccionar y probar funciones por tu cuenta sin afectar a los demás de tu proyecto.

  9. Opcional: Si quieres seguir los ejemplos de este documento, primero crea la tabla Singers como se describe en Crea un esquema para tu base de datos.

Para inhabilitar las funciones de Gemini en Spanner, repite el proceso estos pasos y, luego, anula la selección de las funciones de Gemini que quieras inhabilitar.

Roles obligatorios

Para obtener los permisos que necesitas para completar las tareas de este documento, solicita a tu administrador que te otorgue el Rol de IAM de Lector de base de datos de Spanner (roles/spanner.databaseReader) 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.

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?"

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

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

    Ir a Spanner

  2. Elige una instancia de la lista.

  3. Selecciona una base de datos.

  4. En el panel de navegación, haz clic en Spanner Studio. En el panel Explorador, se muestra una lista de objetos en tu base de datos.

  5. Para consultar tu base de datos, haz clic en la Nueva pestaña del editor de SQL. Asegúrate de que la generación de SQL esté habilitada.

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

    Por ejemplo, si ingresas el mensaje -- add a row to table singers y presiona Return y, luego, Gemini generará SQL 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, si ingresas instrucción -- show all singers born in the 70s y, luego, Gemini genera un SQL similar al siguiente:

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

    • Para aceptar el SQL que genera Gemini, presiona Tab y, luego, haz clic en Ejecutar para ejecutar el SQL sugerido.
    • Para editar el SQL que generó Gemini, presiona Tab, edita el SQL y, luego, haz clic en Ejecutar.
    • Para descartar una sugerencia, presiona EscEsc o continúa escribiendo.

Completa instrucciones de SQL en el editor de consultas

Para ayudarte a escribir código SQL, Gemini en Spanner proporciona sugerencias de finalización de código asistidas por IA. Con Gemini cuando ingreses texto en el editor de consultas de Spanner Studio, Gemini predice y autocompleta el código de SQL.

Sugerencias de código intercalado

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

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

    Ir a Spanner

  2. Elige una instancia de la lista.

  3. Selecciona una base de datos.

  4. En el panel de navegación, haz clic en Spanner Studio.

  5. Para consultar tu base de datos, haz clic en Nueva pestaña de editor de SQL. Asegúrate de que La finalización de SQL está habilitada.

  6. 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 SQL: 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')
    
  7. Revisa la sugerencia de SQL y realiza cualquiera de las siguientes acciones:

    • Para aceptar el SQL que genera Gemini, presiona Tab y, luego, haz clic en Ejecutar para ejecutar el SQL sugerido.
    • Para editar el SQL que generó Gemini, 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 Spanner.

    Ir a Spanner

  2. Elige una instancia de la lista.

  3. Selecciona una base de datos.

  4. En el panel de navegación, haz clic en Spanner Studio.

  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.

Explica instrucciones de SQL en el editor de consultas

Puedes usar Gemini en Spanner 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 Spanner.

    Ir a Spanner

  2. Elige una instancia de la lista.

  3. Selecciona una base de datos.

  4. En el panel de navegación, haz clic en Spanner Studio.

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

  6. En el editor de consultas, pega la consulta.

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

    La explicación de SQL aparece en el panel Gemini.

¿Qué sigue?