Agrega etiquetas de ejecución

En este documento, se muestra cómo agregar etiquetas a los archivos SQLX del núcleo de Dataform para categorizar tu flujo de trabajo de SQL.

Para organizar los componentes de tu flujo de trabajo de SQL en colecciones, puedes agregar etiquetas personalizadas a los archivos SQLX de los siguientes tipos:

  • table
  • view
  • incremental
  • assertion
  • operations

Durante la ejecución del flujo de trabajo, puedes ejecutar solo archivos con una etiqueta seleccionada.

Con Cloud Composer o Workflows junto con Cloud Scheduler, puedes crear un programa que ejecute un flujo de trabajo de Dataform con una etiqueta seleccionada en un intervalo específico.

Antes de comenzar

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

    Ve a la página Dataform

  2. Selecciona o crea un repositorio.

  3. Selecciona o crea un lugar de trabajo de desarrollo.

  4. Define un archivo SQLX de cualquiera de los siguientes tipos:

Roles obligatorios

Para obtener los permisos que necesitas para agregar una etiqueta a una tabla, pídele a tu administrador que te otorgue el rol de IAM de Editor de formularios de datos (roles/dataform.editor) en los espacios de trabajo. 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 mediante roles personalizados o cualquier otro rol predefinido.

Agregar una etiqueta

Puedes agregar varias etiquetas a un archivo SQLX.

Para agregar una etiqueta a un archivo SQLX, sigue estos pasos:

  1. Ve a tu lugar de trabajo de desarrollo.
  2. En el panel Archivos, expande definitions/.
  3. Selecciona un archivo SQLX.

  4. En el bloque config, agrega una etiqueta con el siguiente formato:

    tags: ["CUSTOM_TAG"]

    Reemplaza CUSTOM_TAG por tu etiqueta.

  5. Opcional: Para agregar varias etiquetas, sepáralas con una coma ,.

  6. Opcional: Haz clic en Formato.

En la siguiente muestra de código, se muestra la vista user_counts con las etiquetas daily y hourly:

config {
  type: "view",
  name: "user_counts",
  tags: ["daily", "hourly"]
}

¿Qué sigue?