Escribe SQL con la ayuda de Gemini

MySQL   |  PostgreSQL   |  SQL Server

Vista previa — Gemini Code Assist

Esta función está sujeta a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Puedes procesar los datos personales para esta función como se describe en el Anexo de Procesamiento de Datos de Cloud, sujeto a las obligaciones y restricciones que se describen en el acuerdo en virtud del cual accedes a Google Cloud. Las funciones de fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Como tecnología en etapa inicial, Gemini puede generar resultados que parecen posibles, pero que no son correctos. Te recomendamos validar todos los resultados de Gemini antes de usarlos. Para obtener más información, consulta Gemini para Google Cloud y la IA responsable.

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:

• Genera consultas en SQL con instrucciones escritas en lenguaje natural
• Completa instrucciones de SQL en el editor de consultas
• Explica las consultas de SQL en el editor de consultas

Gemini no usa tus mensajes ni sus respuestas como datos para entrenar sus modelos. Para obtener más información, consulta Cómo 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 BYTEA,
     BirthDate  TIMESTAMPTZ
   );
   

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

Roles y permisos requeridos

Precaución: Los usuarios con un acceso amplio a la base de datos podrían experimentar una pérdida de datos cuando usan Gemini en bases de datos. Te recomendamos que uses una cuenta con menos privilegios de base de datos cuando uses Gemini en bases de datos.

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.

También puedes obtener los permisos necesarios a través de 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 ayudame código.

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.

Nota: Cuando ingresas una instrucción para Gemini en Cloud SQL, esta incluye información sobre el esquema de tu base de datos. Este metadatos puede incluir nombres de tablas y columnas, tipos de datos y descripciones de columnas. Los datos de tu base de datos permanecen en Cloud SQL y no se envían a 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'
   
   

   Nota: Gemini puede sugerir consultas distintas cada vez que ingresas la instrucción.

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');
   

   Nota: Gemini puede sugerir una sintaxis diferente cada vez que ingresas la misma instrucción.

8. Revisa la consulta en SQL generada y realiza cualquiera de las siguientes acciones:

   • Para aceptar el SQL generado por Gemini, haz clic en Insertar a fin de 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')
   

   Nota: Gemini puede sugerir consultas distintas cada vez que ingresas la misma declaración.

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 de SQL aparece en la ventana Chat de Gemini.

¿Qué sigue?

• Lee la descripción general de Gemini en Google Cloud.
• Descubre cómo Gemini usa tus datos.
• Aprende a analizar tus datos en Google Cloud con Gemini.