Escribir SQL con la asistencia de Gemini

Vista previa

Este producto está cubierto por los Términos de las Ofertas Previas a la Disponibilidad General de los Google Cloud Términos del Servicio. Los productos previos a la disponibilidad general pueden tener una asistencia limitada y los cambios que se produzcan en ellos podrían no ser compatibles con otras versiones previas a la disponibilidad general. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

En este documento se describe cómo puedes usar Gemini, un colaborador basado en IA enGoogle Cloud, para hacer lo siguiente en AlloyDB para PostgreSQL:

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

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

Este documento está dirigido a administradores de bases de datos e ingenieros de datos que estén familiarizados con AlloyDB y tengan ciertos conocimientos de SQL y análisis de datos. Si no conoces AlloyDB, consulta la información general sobre AlloyDB.

Nota: La asistencia de programación forma parte de Gemini Code Assist y está disponible sin coste económico 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 AlloyDB para PostgreSQL Studio.

Antes de empezar

1. Asegúrate de que Gemini Cloud Assist esté configurado en tu Google Cloud cuenta de usuario y proyecto.

2. Opcional: Si quieres seguir los ejemplos de este documento, crea la tabla Singers con el siguiente esquema:

   CREATE TABLE Singers (
     BirthDate  TIMESTAMPTZ,
     SingerId   BIGINT PRIMARY KEY,
     FirstName  VARCHAR(1024),
     LastName   VARCHAR(1024),
     SingerInfo BYTEA
   );
   

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

Para inhabilitar las funciones de Gemini en AlloyDB, repite este paso y, a continuación, desmarca las funciones de Gemini que quieras inhabilitar.

Roles y permisos necesarios

Precaución: Los usuarios con un acceso amplio a la base de datos podrían perder datos al usar Gemini. Te recomendamos que uses una cuenta con menos privilegios de base de datos al usar Gemini.

Para usar Gemini con AlloyDB, necesitas los siguientes permisos:

• alloydb.clusters.get
• alloydb.databases.list
• alloydb.instances.executeSql
• alloydb.instances.list
• alloydb.users.list
• cloudaicompanion.companions.generateCode
• cloudaicompanion.instances.generateCode
• serviceusage.services.get o serviceusage.services.list

Puedes obtener este permiso a través del rol roles/alloydb.admin. Si no tienes este rol, ponte en contacto con el administrador de tu organización para solicitar acceso. También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Además, asegúrese de que tiene permisos a nivel de base de datos para la base de datos que está usando para la autenticación.

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 de 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 para hacer un seguimiento de los resultados de la encuesta de satisfacción de los clientes".
• "Añade una columna de fecha llamada cumpleaños a la tabla Singers".
• "¿Cuántos cantantes nacieron en los 90?"

Si tu esquema cambia (por ejemplo, si se añade una tabla o una columna), debes hacer clic en ActualizarActualizar para actualizarlo antes de usar Gemini.

Nota: Cuando introduces una petición, se incluye información sobre el esquema de tu base de datos en 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 AlloyDB y no se envían a Gemini.

Para generar SQL en AlloyDB con la asistencia de Gemini, sigue estos pasos:

1. En la consola de Google Cloud , abre la página AlloyDB.

   Ir a AlloyDB

2. Selecciona un clúster de la lista.

3. En el menú de navegación, haz clic en AlloyDB.

4. Selecciona una base de datos y un usuario, e introduce la contraseña del usuario.

5. Haz clic en Autenticar. En el panel Explorador se muestra una lista de los objetos de la base de datos.

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

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

   Por ejemplo, si introduces la petición -- add a row to table singers y pulsas Intro, Gemini genera 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 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.

8. Revisa la sugerencia de SQL y lleva a cabo alguna de las siguientes acciones:

   Precaución: Las consultas del lenguaje de manipulación de datos (DML) y del lenguaje de definición de datos (DDL) generadas por Gemini pueden sobrescribir datos, por lo que te recomendamos que valides las consultas SQL generadas antes de ejecutarlas.
   • Para ver las opciones para aceptar el SQL generado por Gemini, coloca el puntero sobre la consulta. Se mostrarán las siguientes opciones:
     • Aceptar: para aceptar la consulta sugerida, pulsa Tab y, a continuación, haz clic en Ejecutar.
     • Aceptar palabra: para aceptar parcialmente la consulta sugerida, pulsa Control+Right arrow (o Command+Right arrow en macOS) y, a continuación, haz clic en Ejecutar.
   • Para editar el SQL original, pulsa Tab, edita el SQL y, a continuación, haz clic en Ejecutar.
   • Para descartar la sugerencia, pulsa Esc o sigue escribiendo.

Herramienta Ayúdame a programar

Para usar la herramienta Ayúdame a escribir código, sigue estos pasos:

1. En la consola de Google Cloud , abre la página AlloyDB.

   Ir a AlloyDB

2. Selecciona un clúster de la lista.

3. En el menú de navegación, haz clic en AlloyDB.

4. Selecciona una base de datos y un usuario, e introduce la contraseña del usuario.

5. Haz clic en Autenticar. En el panel Explorador se muestra una lista de los objetos de la base de datos.

6. Para consultar tu base de datos, haz clic en la nueva pestaña.

7. Haz clic en pen_spark Ayúdame a escribir código junto al editor de consultas.

8. En la ventana Ayúdame a programar, introduce una petición. Por ejemplo, add a row to table singers y haz clic en Generar.

   Gemini genera un código SQL similar al 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 introduzcas la misma petición.

9. Revisa el código SQL generado y lleva a cabo alguna de las siguientes acciones:

   Precaución: Las consultas de lenguaje de manipulación de datos (DML) y de lenguaje de definición de datos (DDL) que genera Gemini pueden sobrescribir datos, por lo que te recomendamos que valides las consultas generadas antes de ejecutarlas.
   • Para aceptar el código SQL generado por Gemini, haz clic en Insertar para insertar la instrucción en el editor de consultas. A continuación, haz clic en Ejecutar para ejecutar el SQL sugerido.
   • Para pedirle a Gemini que genere una nueva consulta, haz clic en Editar. Cuando hayas editado la petición, haz clic en Actualizar. Después, puedes aceptar la nueva declaración generada o rechazar la sugerencia.
   • Para descartar la sugerencia, cierra la ventana Ayúdame a escribir código.

Explicar las instrucciones SQL en el editor de consultas

Puedes introducir consultas en lenguaje natural para solicitar explicaciones de consultas de SQL. Estas explicaciones pueden ayudarte a entender la sintaxis, el esquema subyacente y el contexto empresarial de las consultas complejas o largas.

1. En la consola de Google Cloud , abre la página AlloyDB.

   Ir a AlloyDB

2. Selecciona un clúster de la lista.

3. En el menú de navegación, haz clic en AlloyDB.

4. Selecciona una base de datos y un usuario, e introduce la contraseña del usuario.

5. Haz clic en Autenticar. En el panel Explorador se muestra una lista de los objetos de la base de datos.

6. Para consultar tu base de datos, haz clic en la nueva pestaña.

7. En el editor de consultas, pega la consulta.

8. Selecciona la consulta que quieras que Gemini explique y haz clic en pen_spark Explica esta consulta.

   La explicación de SQL aparece en la ventana Chat de Gemini.

Usar Gemini para corregir errores en las consultas

Vista previa — Gemini Code Assist

Esta función está sujeta 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. Puedes tratar datos personales para esta función tal como se indica en la Adenda sobre Tratamiento de Datos de Cloud, de acuerdo con las obligaciones y restricciones descritas en el contrato en virtud del cual accedes a Google Cloud. 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.

Gemini ofrece una función ampliada que te ayuda a corregir errores en tus consultas de AlloyDB sin tener que salir del editor de consultas.

Las funciones basadas en IA de Gemini están integradas en el editor de consultas para ofrecer las siguientes ventajas:

• Ofrece una comparación línea por línea de la consulta original junto a una nueva consulta con los cambios recomendados mediante el editor de consultas.
• Destaca los segmentos de la consulta original que pueden 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 a la consulta para proporcionar correcciones precisas y relevantes.
• Elimina la necesidad de depender de LLMs de terceros y de uso general que pueden proporcionar ayuda menos matizada y que también pueden exponer tus datos a posibles riesgos de seguridad.
• Ofrece una solución de problemas más rápida y eficiente para problemas habituales, como errores de sintaxis, de esquema y de tiempo de ejecución.

Permisos obligatorios

Antes de empezar, confirma que tienes los siguientes permisos:

• Los permisos descritos en la sección Permisos necesarios.
• El permiso de la API Gemini para Google Cloud, cloudaicompanion.googleapis.com/instances.generateCode.

Corregir una consulta con Gemini

Para usar las funciones de Gemini y corregir determinados errores en una consulta, haz lo siguiente:

1. En la Google Cloud consola, abre la página AlloyDB para PostgreSQL.

   Ir a AlloyDB

2. Selecciona un clúster de la lista.

3. En el menú de navegación, haz clic en AlloyDB Studio.

4. Selecciona una base de datos y un usuario, e introduce la contraseña del usuario.

5. Haz clic en Autenticar. En el panel Explorador se muestra una lista de los objetos de la base de datos.

6. En la barra de tareas, haz clic en pen_sparkGemini para ver las funciones de Gemini en AlloyDB.

7. Para consultar tu base de datos, haz clic en Nueva pestaña.

8. En el editor de consultas, escribe una consulta que pueda ser incorrecta o estar incompleta.

9. Haz clic en Ejecutar.

   Si la consulta contiene algún problema, se devuelve un error en la pestaña Resultados.

10. Haz clic en Corregir.

    En la ventana de consulta, se abre un editor de diferencias en la pestaña, que muestra una comparación línea por línea de la consulta actual con los cambios recomendados. El editor de consultas también ofrece un resumen de los cambios sugeridos.

11. Revisa los cambios sugeridos en la consulta y actualízala según sea necesario.

12. Para aceptar los cambios y ejecutar la nueva consulta, haz clic en Aceptar y ejecutar.

Limitaciones

• Solo se puede acceder a esta función en el editor de consultas de AlloyDB Studio en laGoogle Cloud consola.
• Se aplican los límites actuales de la ventana de contexto de Gemini.

Siguientes pasos

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