Escribe SQL con la ayuda de Gemini

Vista previa

Este producto está cubierto por las Condiciones de las Ofertas de Fase Previa a la DG de las Condiciones del Servicio de Google Cloud . Los productos de la fase previa a la DG pueden tener asistencia limitada, y los cambios en los productos de la fase previa a la DG puede que no sean compatibles con otras versiones anteriores a la disponibilidad general. 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 AlloyDB para PostgreSQL:

• 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 AlloyDB y tengan cierto conocimiento de SQL y análisis de datos. Si es la primera vez que usas AlloyDB, consulta la Descripción general de AlloyDB.

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 AlloyDB for PostgreSQL Studio.

Antes de comenzar

1. Asegúrate de que Gemini Cloud Assist esté configurado para 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, luego, anula la selección de las funciones de Gemini que deseas inhabilitar.

Roles y permisos requeridos

Precaución: Los usuarios con un acceso amplio a la base de datos podrían experimentar una pérdida de datos cuando usan Gemini. Te recomendamos que uses una cuenta con menos privilegios de base de datos cuando uses 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 de roles/alloydb.admin. Si no tienes esta función, comunícate con el administrador de tu organización para solicitar acceso. También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Además, asegúrate de tener permisos a nivel de base de datos para la base de datos que usas en la autenticación.

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, debes hacer clic en actualizarActualizar para actualizar tu esquema antes de usar Gemini.

Nota: Cuando ingresas una instrucción, 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 AlloyDB y no se envían a Gemini.

Para generar código SQL en AlloyDB con la ayuda 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, y luego ingresa la contraseña del usuario.

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

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

7. Para generar SQL, escribe un comentario en el editor de consultas a partir de -- seguido de uncomentario de una línea y luego presionaRetorno.

   Por ejemplo, si ingresas la instrucción -- add a row to table singers y presionas Retorno, 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.

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

   Precaución: Debido a que las consultas de 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 de SQL 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 , 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, y luego ingresa la contraseña del usuario.

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

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

7. Haz clic en pen_spark Help me code junto al editor de consultas.

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

9. 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 ingresar consultas en lenguaje natural para solicitar explicaciones de las consultas de SQL. Estas explicaciones pueden ayudarte a comprender la sintaxis, el esquema subyacente y el contexto empresarial para 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, y luego ingresa la contraseña del usuario.

5. Haz clic en Autenticar. En el panel Explorador, se muestra una lista de los objetos de tu 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. Destaca la consulta que quieres que Gemini te explique y haz clic en pen_spark Explica esta consulta.

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

Usa Gemini para corregir errores en las consultas

Versión preliminar — 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, con sujeción a las obligaciones y restricciones descritas 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 AlloyDB sin tener que salir del editor de consultas.

Las capacidades potenciadas por IA de Gemini están integradas en el editor de consultas 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 consultas.
• 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 búsqueda para proporcionar correcciones precisas y pertinentes.
• Elimina la necesidad de depender de LLMs 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 permisos que se describen en Permisos necesarios
• 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 la consola de Google Cloud , abre la página de 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, y luego ingresa la contraseña del usuario.

5. Haz clic en Autenticar. En el panel Explorador, se muestra una lista de los objetos de tu 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, ingresa una consulta que podría ser incorrecta o estar incompleta.

9. Haz clic en Ejecutar.

   Si la búsqueda contiene un problema, se mostrará un error en la pestaña Resultados.

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

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

12. 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 AlloyDB 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.