Escribe SQL con la ayuda de Gemini

Vista previa — Gemini in Spanner

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. 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 potenciado por IA en Google Cloud, para que te ayude a hacer lo siguiente en Spanner:

• Generar consultas en SQL con instrucciones en lenguaje natural
• Completar instrucciones de SQL en el editor de consultas
• Explicar consultas en SQL en el editor de consultas

Gemini no usa tus instrucciones 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 los administradores de bases de datos y a los ingenieros de datos que estén familiarizados con Spanner, SQL y el análisis de datos. Si es la primera vez que usas Spanner, consulta Crea y consulta una base de datos mediante la consola de Google Cloud.

Antes de comenzar

1. Asegúrate de haber configurado Gemini en las 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 características de Gemini en Spanner.

8. Selecciona las funciones de Gemini que deseas habilitar, por ejemplo, Finalización de SQL y Generación de comentarios a consultas. Puedes seleccionar y probar las funciones por tu cuenta sin afectar a otros que trabajan 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.

Funciones obligatorias

Si quieres obtener los permisos necesarios para completar las tareas de este documento, pídele a tu administrador que te otorgue el rol de IAM Lector de bases de datos de Spanner (roles/spanner.databaseReader) en el proyecto. Si quieres obtener más información para otorgar funciones, consulta Administra el acceso.

Es posible que también puedas obtener los permisos necesarios a través de los roles personalizados o de otros roles predefinidos.

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

Nota: Cuando ingresas un mensaje para Gemini en Spanner, este se incluye información sobre el esquema de la base de datos. Esto puede incluir nombres de tablas y columnas, tipos de datos y descripciones de columnas. El esquema y los datos de la 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 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 de 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 con -- seguido de un comentario de una sola línea y, luego, presiona Return.

   Por ejemplo, si ingresas el mensaje -- add a row to table singers y presionas Return, 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 la instrucción -- show all singers born in the 70s, Gemini generará 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 ingresas la misma instrucción.

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

   • Para aceptar el SQL generado por 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.

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 habilitado, cuando ingresas texto en el editor de consultas de Spanner Studio, Gemini predice y autocompleta el código SQL.

Sugerencias de códigos intercalados

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, comienza a escribir el 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')
   

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

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

   • Para aceptar el SQL generado por 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.

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

   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 Insert para insertar la instrucció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 de 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?

• 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.