Agrega etiquetas de BigQuery

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

BigQuery permite 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.

    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.

Funciones obligatorias

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 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 de BigQuery

Para agregar una etiqueta de BigQuery a una tabla en Dataform, agrégala al bloque bigquery en el bloque config del archivo SQLX de definición de tabla.

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

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

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

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

    Reemplaza lo siguiente:

    • LABEL1: Es el nombre de la etiqueta.
    • VALUE_OF_LABEL1: Es el valor de la etiqueta.

  5. Opcional: Para agregar una etiqueta con un nombre que contenga caracteres especiales, ingresa el nombre 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?