Adicionar rótulos do BigQuery

Este documento mostra como adicionar rótulos a tabelas no Dataform.

O BigQuery oferece suporte à 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.

    Acesse 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 receber as permissões necessárias para adicionar um identificador do BigQuery a uma tabela do Dataform, peça ao administrador para conceder a você o papel do IAM Editor do Dataform (roles/dataform.editor) nos espaços de trabalho. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de 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 de 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, abra definitions/.
  3. Selecione um arquivo de definição de tabela 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 rótulo

  5. Opcional: para adicionar um rótulo com um nome que contém caracteres especiais, insira o nome do rótulo entre aspas "".

  6. Opcional: clique em Formato.

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