Escribe consultas con la asistencia de Gemini

Puedes usar Gemini, un colaborador potenciado por IA en Google Cloud, para generar código principal de SQL y Dataform dentro de archivos .sqlx en Dataform.

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

Gemini solo admite instrucciones en inglés en Dataform.

Este documento está dirigido a analistas, científicos y desarrolladores de datos que trabajan con flujos de trabajo de SQL en Dataform. Se supone que tienes conocimiento de la sintaxis de Google SQL y de cómo crear acciones de flujo de trabajo de Dataform SQL.

Antes de comenzar

  1. In the Google Cloud console, go to the project selector page.

    Go to project selector

  2. Select or create a Google Cloud project.

  3. Activa Gemini en BigQuery.

Genera una consulta

Puedes proporcionarle a Gemini una instrucción de lenguaje natural (o instrucción) para generar una consulta principal de SQL o Dataform basada en acciones de flujo de trabajo de SQL definidas en tu repositorio. Por ejemplo, puedes usar Gemini para generar una instrucción SELECT de SQL en un archivo de definición de tablas .sqlx.

Para generar una consulta principal de SQL o Dataform, sigue estos pasos:

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

    Ir a la página de Dataform

  2. Selecciona o crea un repositorio y, luego, selecciona o crea un lugar de trabajo.

  3. En el panel Files, selecciona o crea un archivo .sqlx.

  4. En la pestaña de archivo, haz clic en pen_spark Gemini.

  5. En el diálogo de Gemini, ingresa una instrucción en lenguaje natural.

    Si conoces la acción de SQL que quieres usar, puedes especificar el nombre de la acción entre acentos graves (`) en tu instrucción.

  6. Haz clic en Generar.

    Gemini revisa las acciones de SQL definidas en tu repositorio para encontrar acciones que puedan ser relevantes para tu instrucción.

  7. Opcional: Para proporcionar comentarios, haz clic en thumb_up Me gusta la sugerencia, thumb_down No me gusta la sugerencia o chat_info Enviar más comentarios

  8. Para aceptar la sugerencia, haz clic en Insertar.

Sugerencias para la generación de consultas

Las siguientes sugerencias pueden mejorar las sugerencias que proporciona Gemini en Dataform:

  • Proporciona el nombre de la acción de SQL encerrado entre acentos graves (`), como `action_name`.
  • Si los nombres de las columnas o sus relaciones semánticas no son claros o complejos, puedes proporcionar contexto en el mensaje para guiar a Gemini hacia la respuesta que deseas. Esta técnica se conoce como ingeniería de instrucciones. Por ejemplo, para fomentar que una consulta generada haga referencia a un nombre de columna, describe el nombre de la columna y su relevancia en relación con la respuesta que deseas. Para fomentar una respuesta que haga referencia a términos complejos como el valor del ciclo de vida del cliente o el margen bruto, describe el concepto y su relevancia para tus datos para mejorar los resultados de la generación de SQL.

Datos de Gemini y Dataform

Gemini en Dataform puede acceder a los metadatos de las tablas a las que tienes permiso para acceder. Esto puede incluir los nombres de tablas y de columnas, los tipos de datos y las descripciones de las columnas. Gemini en Dataform no puede acceder a los datos de tus tablas, vistas o modelos. Para obtener más información sobre cómo Gemini usa tus datos, consulta Cómo Gemini en Google Cloud usa tus datos.

¿Qué sigue?