Como formatar valores de dados com LookML

Nesta página, você encontra uma visão geral dos parâmetros LookML que modificam a aparência e o comportamento dos valores de dados exibidos em 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. Também é possível especificar comportamentos clicáveis para que os usuários possam clicar neles e acionar ações ou seguir links.

Como modificar a formatação dos valores de dados

Nesta seção, descrevemos os parâmetros do LookML que alteram como os valores de 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 no estilo Excel.

Observe que value_format não afeta os 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.

Observe que value_format e value_format_name não afetam 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 alterar 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, você pode alterar a fonte, o tamanho e o peso ou a cor da fonte. O exemplo nesta tabela mostra como adicionar emojis a um campo com base no valor dele. 

dimension: status {
  sql: ${TABLE}.status ;;
  html: {% dynamic if value == 'Shipped' or value == 'Complete' %}
      <p>✅ {{value}}</p>
    {% elsif value == 'Processing' %}
      <p>⏳ {{value}}</p>
    {% dynamic else %}
      <p>❌ {{value}}</p>
    {% dynamic endif %}
   ;;
}
sql Use o parâmetro sql para alterar os valores dos dados usando SQL.

Use quaisquer transformações SQL permitidas pelo seu 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 ;;
}

Como modificar ações clicáveis para valores de dados

Nesta seção, descrevemos os parâmetros do LookML que determinam o comportamento de um campo ao clicar nos 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 exibidos quando o usuário detalha os dados. As dimensões e as medições têm um comportamento de detalhamento diferente.

Confira opções avançadas para criar um caminho de detalhamento personalizado em Análise de dados mais eficiente. 

dimension: country {
  sql: ${TABLE}.country ;;
  drill_fields: [state, city]
}
action Use action para criar uma ação de dados em um campo. Assim, os usuários podem realizar tarefas em outras ferramentas diretamente no Looker.

Quando um campo tem uma ou mais ações definidas, reticências (...) aparecem ao lado dele nas tabelas de dados. Ao clicar no campo ou nas reticências, será exibido um menu em que 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, as reticências (...) aparecem ao lado do campo nas tabelas de dados. Ao clicar no campo ou nas reticências, será exibido um menu em que 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 uma formatação HTML personalizada para um campo. Com tags HTML, como <a>, é possível especificar um ou mais hiperlinks no seu campo.

Se um campo tiver uma ou mais ações ou links definidos, as 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 em que os usuários podem selecionar 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
}