O BigQuery é compatível com a adição de rótulos aos recursos. Para mais informações sobre rótulos no BigQuery, consulte Introdução aos rótulos.
Antes de começar
No console do Google Cloud, acesse a página Dataform.
Selecione ou crie um repositório.
Selecione ou crie um espaço de trabalho de desenvolvimento.
Funções exigidas
Para ter as permissões necessárias para adicionar um rótulo do BigQuery
a uma tabela do Dataform,
peça ao administrador para conceder a você o
papel do IAM de Editor do Dataform (roles/dataform.editor
) nos espaços de trabalho.
Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.
Talvez você também consiga receber as permissões necessárias por meio de papéis personalizados ou outros papéis predefinidos.
Adicionar um rótulo do BigQuery
Para adicionar um rótulo do BigQuery a uma tabela no Dataform,
adicione o rótulo ao bloco bigquery
no bloco config
do
arquivo SQLX de definição da tabela.
Para adicionar um rótulo do BigQuery a um arquivo de definição de tabela, siga estas etapas:
- Acesse seu espaço de trabalho de desenvolvimento.
- No painel Files, expanda
definitions/
. - Selecione um arquivo de definição de tabela do SQLX.
No bloco
config
, adicione um rótulo no seguinte formato:bigquery: { labels: { LABEL1: "VALUE_OF_LABEL1" } }
Substitua:
- LABEL1: o nome do rótulo.
- VALUE_OF_LABEL1: o valor do seu rótulo.
Opcional: para adicionar um rótulo com um nome que contenha caracteres especiais, insira o nome do rótulo entre aspas
""
.Opcional: clique em Formatar.
O exemplo de código a seguir mostra os rótulos department:shipping
e cost-center:logistics
adicionados ao bloco bigquery
em um arquivo SQLX de definição de tabela particionada:
config {
type: "table",
bigquery: {
partitionBy: "DATE(ts)",
labels: {
department: "shipping",
"cost-center": "logistics"
}
}
}
SELECT CURRENT_TIMESTAMP() AS ts
A seguir
- Para saber como reutilizar o código com inclusões, consulte Reutilizar variáveis e funções com inclusões.
- Para aprender a acionar execuções manualmente, consulte Execução de gatilho.