Adicionar rótulos do BigQuery

Neste documento, mostramos como adicionar rótulos a tabelas no Dataform.

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

  1. No console do Google Cloud, acesse a página Dataform.

    Acessar a página do Dataform

  2. Selecione ou crie um repositório.

  3. Selecione ou crie um espaço de trabalho de desenvolvimento.

  4. Crie uma tabela.

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:

  1. Acesse seu espaço de trabalho de desenvolvimento.
  2. No painel Files, expanda definitions/.
  3. Selecione um arquivo de definição de tabela do SQLX.
  4. 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.
  5. Opcional: para adicionar um rótulo com um nome que contenha caracteres especiais, insira o nome do rótulo entre aspas "".

  6. 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