Escribir SQL con la asistencia de Gemini

Vista previa — Gemini in Spanner

Esta función está sujetas a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Las funciones previas a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

En este documento se describe cómo puedes usar Gemini Code Assist para obtener asistencia basada en IA con lo siguiente en Spanner:

• Generar consultas de SQL mediante peticiones en lenguaje natural.
• Explicar consultas de SQL en el editor de consultas.

Consulta cómo y cuándo Gemini Google Cloud usa tus datos.

Este documento está dirigido a administradores de bases de datos e ingenieros de datos que estén familiarizados con Spanner, SQL y el análisis de datos. Si no has usado Spanner antes, consulta el artículo sobre cómo crear y consultar una base de datos con la consola Google Cloud .

Nota: La asistencia de programación forma parte de Gemini Code Assist y está disponible sin coste adicional hasta que se incluya en la edición Gemini Code Assist Standard. Este cambio se comunicará más adelante. En ese momento, tendrás que adquirir una licencia de la edición Gemini Code Assist Standard para seguir usando la asistencia de programación en Spanner Studio.

Antes de empezar

1. Opcional: configura Gemini Code Assist.

2. Para completar las tareas de este documento, asegúrate de tener los permisos de gestión de identidades y accesos (IAM) necesarios.

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

   Ir a Spanner

4. Selecciona 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 quieras habilitar. Por ejemplo, Generación de consultas a partir de comentarios. Puedes seleccionar y probar funciones sin que afecte a otros usuarios que trabajen en tu proyecto.

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

Para inhabilitar las funciones de Gemini en Spanner, repite estos pasos y desmarca las funciones de Gemini que quieras inhabilitar.

Roles obligatorios

Para obtener los permisos que necesitas para completar las tareas de este documento, pide a tu administrador que te asigne el rol de gestión de identidades y accesos Usuario de Gemini for Google Cloud (roles/cloudaicompanion.user) en el proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Generar consultas de SQL con peticiones en lenguaje natural

Dado que la tecnología de Gemini está en una fase inicial, puede que genere resultados que sean incorrectos aunque parezcan plausibles. Google CloudTe recomendamos que valides todos los resultados de Gemini para los productos Google Cloud antes de usarlos. Para obtener más información, consulta el artículo sobre Gemini para Google Cloud y la IA responsable.

Puedes dar comentarios en lenguaje natural (o peticiones) a Gemini para generar consultas basadas en tu esquema. Por ejemplo, puedes pedirle a Gemini que genere SQL en respuesta a las siguientes peticiones:

• "Crea una tabla que registre los resultados de la encuesta de satisfacción de los clientes".
• "Añade una columna de fecha llamada cumpleaños a la tabla Cantantes".
• "¿Cuántos cantantes nacieron en los 90?"

Nota: Cuando introduces una petición para Gemini en Spanner, se incluye información sobre el esquema de tu base de datos con la petición. 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 asistencia de Gemini, sigue estos pasos:

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

   Ir a Spanner

2. Selecciona una instancia de la lista.

3. Selecciona una base de datos.

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

5. Para consultar tu base de datos, haz clic en la pestaña Nuevo editor de SQL. Comprueba que la generación de SQL esté habilitada.

6. Para generar código SQL, escribe un comentario en el editor de consultas que empiece por -- seguido de un comentario de una sola línea y, a continuación, pulsa Return.

   Por ejemplo, si introduces la petición -- add a row to table singers y pulsas Return, 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 de la tabla Singers, si introduces la petición -- show all singers born in the 70s, Gemini genera un código SQL similar al siguiente:

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

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

7. Revisa el código SQL generado y haz lo siguiente:

   • Para aceptar el código SQL generado por Gemini, pulsa Tab y, a continuación, haz clic en Ejecutar para ejecutar el código SQL sugerido.
   • Para editar el código SQL generado por Gemini, pulsa Tab, edita el código SQL y, a continuación, haz clic en Ejecutar.
   • Para descartar la sugerencia, pulsa Esc o sigue escribiendo.

Explicar las instrucciones SQL en el editor de consultas

Puedes usar Gemini en Spanner para explicar consultas de SQL en lenguaje natural. Esta explicación puede ayudarte a entender la sintaxis, el esquema subyacente y el contexto empresarial de las consultas complejas o largas.

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

   Ir a Spanner

2. Selecciona una instancia de la lista.

3. Selecciona una base de datos.

4. En el panel de navegación, haga 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 quieras que Gemini explique y, a continuación, haz clic en chispa Explicar esta consulta.

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

Siguientes pasos

• Consulta la descripción general de Gemini para Google Cloud .
• Consulta cómo usa Gemini tus datos.