Como formatar valores de dados com o LookML

Esta página oferece uma visão geral dos parâmetros do LookML que modificam a aparência e o comportamento dos valores de dados exibidos 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 da 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 as opções 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 integrado ou personalizado.

value_format e value_format_name não têm efeito em 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.

style é o único parâmetro da 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, você pode 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 seu banco de dados. O exemplo desta 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 ;;
}

Como modificar ações clicáveis para 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 métricas têm comportamentos diferentes de detalhamento.

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

Quando um campo tem uma ou mais ações definidas, os pontos suspensivos (...) aparecem ao lado do campo nas tabelas de dados. Ao clicar no campo ou nas reticências, um menu é aberto para que os usuários selecionem uma ação ou aprofundem 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, os pontos de elipse (...) aparecem ao lado dele nas tabelas de dados. Ao clicar no campo ou nas reticências, um menu é aberto para que os usuários selecionem um link ou acessem 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, os pontos de elipse (...) vão aparecer ao lado do campo nas tabelas de dados, independentemente da definição de html. Ao clicar no campo ou nas reticências, um menu é exibido para que os usuários selecionem os links ou ações disponíveis. 
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
}