Agrega etiquetas de BigQuery

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

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

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. 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 Dataform (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.

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 la tabla.

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

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

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

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

    Reemplaza lo siguiente:

    • LABEL1: El nombre de tu etiqueta
    • VALUE_OF_LABEL1: El valor de tu etiqueta

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

  6. Opcional: Haz clic en Formato.

En la siguiente muestra de código, se muestran las etiquetas department:shipping y cost-center:logistics agregadas 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?