Como formatar valores de dados com o LookML

Nesta página, você encontra uma visão geral dos parâmetros do LookML que modificam a aparência e o comportamento dos valores de dados mostrados nas tabelas e visualizações de dados. Por exemplo, é possível especificar a formatação de moeda para que um valor de dados, como 1234, seja renderizado como $1,234.00 em tabelas de dados e visualizações. Você também pode especificar comportamentos clicáveis para que os usuários cliquem nos campos para acionar ações ou seguir links.

Como modificar a formatação dos valores de dados

Esta seção descreve os parâmetros do LookML que mudam a forma como os valores dos dados aparecem para os usuários.

Parâmetro Descrição Exemplo
value_format Use value_format para formatar a saída de um campo type: number usando opções de estilo do Excel.

value_format não tem efeito em campos que não são type: number.		 
measure: total_order_amount {
  type: sum
  sql: ${order_amount} ;;
  value_format: "$#,##0.00"
 }
value_format_name Use value_format para formatar a saída de um campo type: number usando um named_value_format (link em inglês) integrado ou personalizado.

value_format e value_format_name não afetam os campos que não são type: number. 
measure: total_order_amount {
  type: sum
  sql: ${order_amount} ;;
  value_format_name: usd
}
style Use o parâmetro style para mudar a formatação dos campos de type: tier.

Observe que style é o único parâmetro LookML que afeta a formatação dos campos type: tier. 
dimension: age_tier {
  type: tier
  tiers: [0, 10, 20, 30, 40, 50, 60, 70, 80]
  style: classic
  sql: ${age} ;;
}
html Use o parâmetro html para aplicar a formatação HTML ao campo.

Por exemplo, é possível mudar a fonte, o tamanho, o peso ou a cor da fonte. O exemplo desta tabela mostra como adicionar emojis a um campo com base no valor dele. 
dimension: status {
  sql: ${TABLE}.status ;;
  html: {% if value == 'Shipped' or value == 'Complete' %}
      <p>✅ {{value}}</p>
    {% elsif value == 'Processing' %}
      <p>⏳ {{value}}</p>
    {% else %}
      <p>❌ {{value}}</p>
    {% endif %}
   ;;
}
sql Use o parâmetro sql para alterar os valores dos dados usando SQL.

Use qualquer transformação SQL permitida pelo banco de dados. O exemplo nesta tabela mostra como adicionar emojis a um campo com base no valor dele. 
dimension: status {
  sql: CASE WHEN (${TABLE}.status = 'Shipped' OR ${TABLE}.status = 'Complete') ;;
     THEN CONCAT('✅ ', ${TABLE}.status)
   WHEN ${TABLE}.status = 'Processing'
     THEN CONCAT('⏳ ', ${TABLE}.status)
   ELSE
     CONCAT('❌ ', ${TABLE}.status)
   END ;;
}

Modificar ações clicáveis de valores de dados

Esta seção descreve os parâmetros do LookML que determinam o comportamento de um campo ao clicar em valores de dados na tabela ou visualização de dados.

Parâmetro Descrição Exemplo
drill_fields Use drill_fields para especificar quais campos são mostrados quando o usuário detalha os dados. As dimensões e as medidas têm comportamentos diferentes.

Para conferir opções avançadas para criar um caminho de detalhamento personalizado, consulte Detalhamento mais avançado de dados. 
dimension: country {
  sql: ${TABLE}.country ;;
  drill_fields: [state, city]
}
action Use action para criar uma ação de dados em um campo, o que permite que os usuários realizem tarefas em outras ferramentas diretamente do Looker.

Quando um campo tem uma ou mais ações definidas, os pontos suspensivos (...) aparecem ao lado do campo nas tabelas de dados. Clicar no campo ou nas reticências abrirá um menu no qual os usuários podem selecionar uma ação ou detalhar os dados. 
dimension: action_example {
  action: {
    label: "Send a Thing"
    url:
      "https://example.com/ping/{{value}}"
    form_url:
      "https://example.com/ping/{{value}}/form.json"
  }
}
link Use link para criar um link em um campo.

Quando um campo tem um ou mais links definidos, reticências (...) aparecem ao lado do campo nas tabelas de dados. Ao clicar no campo ou nas reticências, será exibido um menu no qual os usuários podem selecionar um link ou detalhar os dados. 
dimension: artist_name {
  link: {
    label: "Google"
    url: "http://www.google.com/search?q={{value}}"
    icon_url: "http://google.com/favicon.ico"
   }
}
html Use html para escrever formatação HTML personalizada para um campo. Com tags HTML, como <a>, é possível especificar um ou mais hiperlinks no campo.

Se um campo tiver uma ou mais ações ou links definidos, reticências (...) aparecerão ao lado do campo nas tabelas de dados, independentemente da definição de html. Ao clicar no campo ou nas reticências, será exibido um menu no qual os usuários podem selecionar qualquer link ou ação disponível. 
dimension: artist_name {
  html: <p>{{value}}
    <a href="#drillmenu">Drill menu</a>,
    <a href="http://www.google.com/search?q={{value}}">
      Google search
    </a></p>;;
    sql: ${TABLE}.artist_name ;;
    type: string
}