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 la Oferta de la Fase Previa a la DG” en la sección Condiciones del Servicio Generales de las Condiciones Específicas del Servicio. Puedes tratar datos personales para esta función como se describe en el Anexo de Tratamiento 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 la fase previa a la DG están disponibles "sin modificaciones" y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

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

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

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.

Nota: La asistencia para la programación forma parte de Gemini Code Assist y está disponible sin cargo hasta que se incluya en la edición estándar de Gemini Code Assist. Este cambio se comunicará en una fecha posterior. En ese momento, deberás adquirir una licencia de la edición estándar de Gemini Code Assist para seguir usando la asistencia para la programación en Cloud SQL Studio.

Antes de comenzar

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

3. 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 VARBINARY(MAX),
     BirthDate  DATETIMEOFFSET
   );
   

   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

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

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 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 podría sugerir consultas cada vez que ingresas la misma instrucción.

9. Revisa la sugerencia de SQL y realiza cualquiera de las siguientes acciones:

   Precaución: Debido a que las consultas en lenguaje de manipulación de datos (DML) y lenguaje de definición de datos (DDL) que genera Gemini pueden sobrescribir datos, te recomendamos que valides las consultas generadas antes de ejecutarlas.
   • 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 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 podría 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:

   Precaución: Debido a que las consultas en lenguaje de manipulación de datos (DML) y lenguaje de definición de datos (DDL) que genera Gemini pueden sobrescribir datos, te recomendamos que valides las consultas generadas antes de ejecutarlas.
   • 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 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 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.

Usa Gemini para corregir errores en las búsquedas

Vista previa — Gemini Code Assist

Esta función está sujeta a las “Condiciones de la Oferta de la Fase Previa a la DG” en la sección Condiciones del Servicio Generales de las Condiciones Específicas del Servicio. Puedes tratar datos personales para esta función como se describe en el Anexo de Tratamiento 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 la fase previa a la DG están disponibles "sin modificaciones" y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Gemini ahora ofrece una capacidad extendida que te ayuda a corregir errores en tus consultas de Cloud SQL sin tener que salir de Cloud SQL Studio.

Las capacidades potenciadas por IA de Gemini están integradas en Cloud SQL Studio para proporcionar los siguientes beneficios:

• Proporciona una comparación línea por línea de la consulta original junto a una nueva consulta con los cambios recomendados usando el editor de Cloud SQL Studio.
• Destaca los segmentos de la búsqueda original que podrían estar causando el problema y proporciona un resumen de los cambios en lenguaje natural.
• Hace referencia al mensaje de error exacto y a la información del esquema asociados con la consulta para proporcionar correcciones precisas y pertinentes.
• Elimina la necesidad de depender de LLMs de uso general de terceros que podrían proporcionar ayuda menos matizada y también exponer tus datos a posibles riesgos de seguridad.
• Proporciona una solución de problemas más rápida y eficiente para problemas comunes, como errores de sintaxis, esquema y tiempo de ejecución.

Permisos necesarios

Antes de comenzar, confirma que tienes los siguientes permisos:

• Los permisos que se describen en Permisos necesarios
• Permiso de la API de Gemini para Google Cloud, cloudaicompanion.googleapis.com/instances.generateCode.

Corrige tu consulta con Gemini y Cloud SQL Studio

Para usar las capacidades de Gemini y corregir ciertos errores en una consulta en Cloud SQL Studio, completa los siguientes pasos:

1. En la consola de Google Cloud , ve a la página 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. Para consultar tu base de datos, haz clic en la Nueva pestaña.

7. En el editor de consultas, ingresa una consulta que podría ser incorrecta o estar incompleta.

8. Haz clic en Ejecutar.

   Si la búsqueda contiene un problema, se muestra un error.

   Por ejemplo, el mensaje que se devuelve podría ser un error de validación en la pestaña Ejecutar o un mensaje de error en la pestaña Resultados.

9. Haz clic en Corregir.

10. En la ventana de consultas, se abre un editor de diferencias ("editor de diff") en la pestaña, que muestra una comparación línea por línea de la consulta existente con los cambios recomendados. El editor de consultas también proporciona un resumen de los cambios sugeridos. Revisa los cambios sugeridos en la búsqueda y actualízala según sea necesario. Luego, acepta y ejecuta tu nueva consulta:

    Haz clic en Aceptar y ejecutar.

Limitaciones

• Solo se puede acceder a esta función desde Cloud SQL Studio en la consola deGoogle Cloud .
• Se aplican los límites actuales de la ventana de contexto de Gemini.

¿Qué sigue?

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