rótulo (para campos)

Esta seção se refere ao parâmetro label que faz parte de um campo.

label também pode ser usado como parte de um modelo, conforme descrito na página de documentação do parâmetro label (para modelos).

label também pode ser usado como parte de uma análise detalhada, conforme descrito na página de documentação do parâmetro label (para análises detalhadas) .

label também pode ser usado como parte de uma visualização, conforme descrito na página de documentação do parâmetro label (para visualizações).

label também pode ser usado como parte de uma linha de referência, descrita na página de documentação Parâmetros da linha de referência do painel.

Uso

view: view_name {
  dimension: field_name {
    label: "desired label name"
  }
}

Hierarquia Ver arquivo view Tipo de campo label

Tipos de campo possíveis Dimensão, grupo de dimensões, métrica, filtro, parâmetro Aceita Uma string

Definição

O label ajuda a tornar as Análises mais fáceis de usar, permitindo que você escolha como os nomes dos campos aparecem no seletor de campos e na tabela de dados de uma Análise. Se nenhum rótulo for especificado, o padrão será o nome do campo.

Observação: label afeta apenas a forma como os nomes dos campos são mostrados no conteúdo do Looker. label não afeta como você se refere ao campo em LookML nem muda o valor no banco de dados. Use a sintaxe ${view_name.field_name} nos arquivos LookML para referenciar campos com rótulos.

Variáveis do Liquid com label

É possível usar variáveis do Liquid com o parâmetro label. Com as variáveis do Liquid, é possível acessar dados como informações sobre um modelo ou uma análise detalhada, filtros aplicados a um campo e valores de atributo do usuário. Você pode usar variáveis Liquid para mudar dinamicamente o valor de label e, assim, alterar a aparência do campo no seletor de campos e nas visualizações de dados.

As variáveis Liquid que retornam um valor com base em um filtro, como _filters, ou exigem que uma consulta seja executada primeiro, como in_query, não mudam o nome do campo no seletor de campos. Nesses casos, o nome do campo só será alterado na visualização resultante.

Por exemplo, a variável Liquid {{ _user_attributes['name_of_attribute'] }} substitui a variável Liquid pelo valor do atributo de usuário especificado. Se um usuário tiver um atributo chamado name com o valor "João Silva", a seguinte sintaxe label mudará o nome do campo no seletor para João Silva:

label: "{{ _user_attributes['name'] }}"

No exemplo a seguir, a dimensão name usa a estrutura {% if %} {% else %} {% endif %} do Liquid com a variável _user_attributes['name_of_attribute'] do Liquid para mudar o valor label dependendo de um atributo do usuário company:

dimension: name {
  label: "{% if _user_attributes['company'] == 'Looker' %} Employee Name {% else %} Customer Name {% endif %}"
  sql: ${TABLE}.name ;;
}

Confira mais exemplos de como usar label com variáveis Liquid para definir rótulos dinâmicos na página de práticas recomendadas Maneiras interessantes de usar o Liquid em rótulos.

Exemplo

Faça com que essa métrica apareça como Número de clientes em vez de Contagem distinta de clientes no seletor de campos.

measure: customer_count_distinct {
  label: "# of Customers"
  type: count_distinct
  sql: ${customer.id} ;;
}

Informações importantes

O ambiente de desenvolvimento integrado sinaliza rótulos duplicados em uma visualização

Para evitar rótulos de campo duplicados na mesma visualização, o IDE do Looker apresenta um ícone de informações ao lado do número da linha de qualquer rótulo de campo duplicado em um arquivo de visualização do LookML. Se você passar o cursor sobre o ícone de informações ao lado do número da linha, a dica de ferramenta vai indicar que já existe um campo com o rótulo na visualização.

O IDE do Looker vai mostrar essas mesmas informações no painel Ajuda rápida se você selecionar o texto da instrução label no IDE: