label (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, descrito na página de documentação de parâmetros label (para modelos).

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

label também pode ser usado como parte de uma visualização, descrita na página de documentação de 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 de linha de referência do painel.

Uso

view: view_name {
dimension: field_name {
label: "nome do rótulo desejado"
}
}

Hierarquia Ver arquivo view Tipo de campo label

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

Definição

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

O rótulo afeta apenas o nome exibido do campo em um Explorar e não afeta a forma como você se refere ao campo em LookML. Os campos com rótulos ainda são referenciados com a sintaxe ${view_name.field_name} normal nos arquivos LookML.

Variáveis líquidas com label

É possível usar variáveis líquidas com o parâmetro label. Com as variáveis líquidas, é possível acessar dados, como informações sobre um modelo ou a exploração, filtros aplicados a um campo e valores de atributo do usuário. É possível usar variáveis Liquid para mudar dinamicamente o valor label, mudando a aparência do campo no seletor de campo e nas visualizações de dados.

As variáveis líquidas que retornam um valor com base em um filtro, como _filters, ou que 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ó é 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 especificado do usuário. Se um usuário tivesse um atributo de usuário chamado name com o valor "John Smith", a seguinte sintaxe label mudaria o nome do campo no seletor de campo para John Smith:

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

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

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

Veja mais exemplos de como usar label com variáveis Liquid para definir rótulos dinâmicos neste artigo da Central de Ajuda.

Exemplo

Faça essa medida aparecer como Número de clientes em vez de Contador de cliente diferente no seletor de campo.

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

Considerações

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 ambiente de desenvolvimento integrado do Looker apresenta um ícone de informação pelo 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 pelo número da linha, a dica indica que já existe um campo com o rótulo na visualização.

O IDE do Looker mostrará essas mesmas informações na ajuda rápida se você clicar no texto da instrução label no ambiente de desenvolvimento integrado: