Escribe SQL con la ayuda de Gemini

Vista previa — Gemini en Bigtable

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 para generar consultas en SQL con instrucciones en lenguaje natural en Bigtable.

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 Bigtable, SQL y el análisis de datos. Si no conoces Bigtable, consulta la guía de inicio rápido: Crea una instancia de Bigtable 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 Bigtable Studio.

Limitaciones

• No puedes usar Gemini en Bigtable para explicar consultas en SQL en lenguaje natural.

• Es posible que Gemini en Bigtable genere consultas que no sean válidas en GoogleSQL para Bigtable o que usen las siguientes instrucciones o sintaxis no admitidas:

  • Declaraciones de lenguaje de manipulación de datos (DML) que no sean SELECT, por ejemplo, INSERT, UPDATE o DELETE
  • Sentencias del lenguaje de definición de datos (DDL), por ejemplo, CREATE, ALTER o DROP
  • Son declaraciones de control de acceso a los datos.
  • Sintaxis de consultas para subconsultas, JOIN, UNION y CTE

  Para obtener más información, consulta la Descripción general de GoogleSQL para Bigtable.

Antes de comenzar

1. Habilita la API de Gemini para Google Cloud en un Google Cloud proyecto.

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

3. Opcional: Si deseas seguir los ejemplos de este documento, crea y propaga test-table como se describe en Crea una tabla de prueba.

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:

• "Cuenta la cantidad de dispositivos que tienen un plan de datos de 1 GB".
• "Enumera todos los teléfonos que se conectaron a Wi-Fi el 1 de mayo de 2019".
• "¿Qué tablets tienen habilitado el plan de datos de 10 GB?"

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

Para generar SQL en Bigtable con Gemini, sigue estos pasos:

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

   Ir a Bigtable

2. Elige una instancia de la lista.

3. En el panel de navegación, haz clic en Bigtable Studio.

4. Haz clic en para abrir una pestaña nueva y, luego, elige Editor.

5. Haz clic en Generar SQL.

6. En el diálogo Help me code, ingresa tu instrucción y, luego, haz clic en Generar.

   Por ejemplo, si ingresas la instrucción Count the number of devices that have a 1GB data plan., Gemini genera un código SQL similar al siguiente:

   SELECT
       count(*)
   FROM
       `test_table`
   WHERE
       cell_plan['data_plan_01gb'] = 'true'
   

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

7. Revisa el código SQL generado y realiza una de las siguientes acciones:

   • Para ejecutar el SQL sugerido, haz clic en Insertar y, luego, en Ejecutar.
   • Para editar la instrucción, haz clic en Editar y, luego, en Actualizar.
   • Para editar el SQL sugerido, haz clic en Insertar. En el compilador de consultas, edita la consulta de forma manual y, luego, haz clic en Ejecutar.

8. Opcional: Para continuar con el ejemplo de test_table, si ingresas la instrucción Show all data for phones from May 2019., Gemini genera un código SQL similar al siguiente:

   SELECT
       *
   FROM
       `test_table`
   WHERE
       _key LIKE 'phone#%#201905%'
   

¿Qué sigue?

• Lee la descripción general de Gemini para Google Cloud .