Escribe SQL con la ayuda de Gemini

Versión preliminar — 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 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 administradores de bases de datos e ingenieros de datos que estén familiarizados con Bigtable, SQL y el análisis de datos. Si es la primera vez que usas Bigtable, consulta Descripción general de Bigtable.

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 consultas que usen las siguientes sentencias o sintaxis no admitidas:

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

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

Antes de comenzar

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

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 quieres 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 (o instrucciones) a Gemini 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 la red 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. Para abrir una pestaña nueva, haz clic en y, luego, elige Editor.

5. Haz clic en Generar SQL.

6. En el diálogo Ayúdame a programar, 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 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 la consulta en SQL generada 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 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 .