Agrega etiquetas de BigQuery

En este documento, se muestra cómo agregar etiquetas a las tablas de Dataform.

BigQuery permite agregar etiquetas a los recursos. Para obtener más información sobre etiquetas en BigQuery, consulta Introducción a las etiquetas.

Antes de comenzar

  1. En Google Cloud Console, 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. Crea una tabla.

Roles obligatorios

Para obtener los permisos que necesitas para agregar una etiqueta de BigQuery a una tabla de Dataform, pídele a tu administrador que te otorgue el rol de IAM Editor de formularios de datos (roles/dataform.editor) en los lugares de trabajo. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Agrega una etiqueta de BigQuery

Para agregar una etiqueta de BigQuery a una tabla en Dataform, agrega la etiqueta al bloque bigquery en el bloque config del archivo SQLX de definición de tablas.

Para agregar una etiqueta de BigQuery a un archivo de definición de tablas, sigue estos pasos:

  1. Ve al lugar de trabajo de desarrollo.
  2. En el panel Archivos, expande definitions/.
  3. Selecciona un archivo de definición de tablas de SQLX.

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

    bigquery: {
    labels: {
      LABEL1: "VALUE_OF_LABEL1"
    }
  }

  5. Reemplaza LABEL1 por el nombre de tu etiqueta.

  6. Reemplaza VALUE_OF_LABEL1 por el valor de tu etiqueta.

  7. Opcional: Para agregar una etiqueta con un nombre que contenga caracteres especiales, ingresa el nombre de la etiqueta entre comillas "".

En la siguiente muestra de código, se muestran las etiquetas department:shipping y cost-center:logistics que se agregaron al bloque bigquery en un archivo SQLX de definición de tabla particionada:

config {
  type: "table",
  bigquery: {
    partitionBy: "DATE(ts)",
    labels: {
      department: "shipping",
      "cost-center": "logistics"
    }
  }
}

SELECT CURRENT_TIMESTAMP() AS ts

¿Qué sigue?