Escribe SQL con la ayuda de Gemini

Versión preliminar — Gemini en Spanner

Esta función está sujeta a las "Condiciones de la oferta previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. 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 Code Assist para obtener asistencia potenciada por IA con lo siguiente en Spanner:

• Genera consultas en SQL con instrucciones 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 bases de datos que estén familiarizados con Spanner, SQL y el análisis de datos. Si no conoces Spanner, consulta Crea y consulta una base de datos con la consola de Google Cloud .

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 Gemini Code Assist Standard para seguir usando la asistencia de programación en Spanner Studio.

Antes de comenzar

1. Opcional: Configura Gemini Code Assist.

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 Spanner Studio, haz clic en el botón settings_suggestion Gemini Code Assist para ver las funciones de Gemini en Spanner.

8. Selecciona las funciones de Gemini que quieras habilitar, por ejemplo, Generación de comentarios a las consultas. Puedes seleccionar y probar funciones por tu cuenta sin afectar a otros usuarios que trabajen en 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 estos pasos y, luego, anula la selección de las funciones de Gemini que deseas inhabilitar.

Roles obligatorios

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 Usuario de Gemini para Google Cloud (roles/cloudaicompanion.user) 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 a través de roles personalizados o cualquier otro rol predefinido.

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

Nota: Cuando ingresas una instrucción para Gemini en Spanner, esta incluye información sobre el esquema de tu base de datos. Esto puede incluir nombres de tablas y columnas, tipos de datos y descripciones de columnas. El esquema y los datos de tu base de datos permanecen en Spanner y no se envían a Gemini.

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 los objetos de tu base de datos.

5. Para consultar tu base de datos, haz clic en la Nueva pestaña. 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 la instrucción -- add a row to table singers y presionas Return, Gemini genera un 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 la instrucción -- show all singers born in the 70s, Gemini genera un SQL similar al siguiente:

   SELECT *
   FROM Singers
   WHERE Singers.BirthDate
   BETWEEN '1970-01-01' AND '1979-12-31'
   
   

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

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 generado por Gemini, 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 Spanner para explicar las consultas en 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 astrophotography_mode Explicar esta consulta seleccionada.

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

Usa Gemini para corregir errores en las búsquedas

Versión preliminar — Gemini Code Assist

Esta función está sujeta a las "Condiciones de la oferta previa a la DG" en la sección Condiciones Generales del Servicio 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 ofrece una capacidad extendida que te ayuda a corregir errores en tus consultas de Spanner sin tener que salir del editor de consultas.

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

• Proporciona una comparación línea por línea de la búsqueda original junto a una nueva búsqueda con los cambios recomendados usando el editor de búsquedas.
• 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 LLM de uso general de terceros que podrían proporcionar ayuda menos detallada 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 roles que se describen en Roles obligatorios
• Permiso de la API de Gemini para Google Cloud, cloudaicompanion.googleapis.com/instances.generateCode.

Corrige tu búsqueda con Gemini

Para usar las capacidades de Gemini y corregir ciertos errores en una búsqueda, completa los siguientes pasos:

1. En el editor de consultas, ejecuta tu consulta.

   Si la consulta contiene un error, se muestra un mensaje de error en un banner de error en la parte inferior del editor.

2. Haz clic en Corregir.

   En la ventana de consulta, 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.

3. Revisa los cambios sugeridos en la búsqueda y actualízala según sea necesario.

4. Para aceptar los cambios y ejecutar la nueva búsqueda, haz clic en Aceptar y ejecutar.

Limitaciones

• Solo se puede acceder a esta capacidad en el editor de consultas de Spanner 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.