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
En la consola de Google Cloud, ve a la página Dataform.
Selecciona o crea un repositorio.
Selecciona o crea un lugar de trabajo de desarrollo.
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:
- Ve a tu lugar de trabajo de desarrollo.
- En el panel Files, expande
definitions/
. - Selecciona un archivo de definición de tablas de SQLX.
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.
Opcional: Para agregar una etiqueta con un nombre que contenga caracteres especiales, ingresa el nombre entre comillas
""
.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?
- Si quieres aprender a reutilizar el código con inclusiones, consulta Cómo reutilizar variables y funciones con inclusiones.
- Para aprender a activar ejecuciones de forma manual, consulta Activa la ejecución.