Crear acciones con la ayuda de Gemini

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

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

Solo se admiten peticiones en inglés para Gemini en Dataform.

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

Antes de empezar

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

    Go to project selector

  2. Select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
  3. Activa Gemini en BigQuery.

Generar una consulta

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

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

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

    Ir a la página de Dataform

  2. Selecciona o crea un repositorio y, a continuación, selecciona o crea un espacio de trabajo.

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

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

  5. En el cuadro de diálogo de Gemini, introduce una petición en lenguaje natural.

    Si sabes qué acción de SQL quieres usar, puedes especificar el nombre de la acción entre comillas inversas (`) en tu petició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 petición 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.

Consejos para generar consultas

Los siguientes consejos pueden mejorar las sugerencias que ofrece Gemini en Dataform:

  • Proporciona el nombre de la acción de SQL entre comillas inversas (`), como `action_name`.
  • Si los nombres de las columnas o sus relaciones semánticas no están claros o son complejos, puedes proporcionar contexto en la petición para guiar a Gemini hacia la respuesta que quieres. Esta técnica se conoce como ingeniería de peticiones. Por ejemplo, para animar a una consulta generada a que haga referencia a un nombre de columna, describe el nombre de la columna y su relevancia para la respuesta que quieres obtener. Para fomentar una respuesta que haga referencia a términos complejos, como valor del tiempo de vida o margen bruto, describe el concepto y su relevancia para tus datos con el fin de 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 tengas permiso para acceder. Esto puede incluir los nombres de las tablas, los nombres de las 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 usa Gemini tus datos, consulta Cómo usa Gemini tus datos Google Cloud .

Siguientes pasos