Agrega etiquetas de ejecución

En este documento, se muestra cómo agregar etiquetas a los archivos SQLX principales de Dataform para categorizar el 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

Puedes ejecutar solo archivos con una etiqueta seleccionada durante la ejecución del flujo de trabajo.

Con Cloud Composer o Flujos de trabajo 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.

    Ir 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:

Funciones obligatorias

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 Dataform (roles/dataform.editor) en los lugares de trabajo. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

Es posible que también puedas obtener los permisos necesarios mediante funciones personalizadas, o bien otras funciones predefinidas.

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 Files, 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?