Crea acciones 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.

Solo los mensajes en inglés son compatibles con Gemini en Dataform.

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

Antes de comenzar

  1. En la Google Cloud consola de, ve a la página del selector de proyectos.

    Ir al selector de proyectos

  2. Selecciona o crea un Google Cloud proyecto de.

    Roles necesarios para seleccionar o crear un proyecto

    • Seleccionar un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
    • Crear un proyecto: Para crear un proyecto, necesitas el rol de creador de proyectos (roles/resourcemanager.projectCreator), que contiene el resourcemanager.projects.create permiso. Obtén más información para otorgar roles.
  3. Activa Gemini en BigQuery.

Genera una consulta

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

Para generar una consulta en SQL o en el código principal de Dataform, sigue estos pasos:

  1. En la Google Cloud consola de, 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 espacio de trabajo.

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

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

  5. En el diálogo de Gemini, ingresa un prompt en lenguaje natural.

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

  6. Haz clic en Generar.

    Gemini revisa las acciones de SQL definidas en tu repositorio para encontrar acciones que podrían ser relevantes para tu prompt y sugiere una consulta.

  7. Opcional: Para enviar 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 generar consultas

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

  • Proporciona el nombre de la acción de SQL 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 para Google Cloud usa tus datos.

¿Qué sigue?