Parâmetros de gráfico de cascata para dashboards do LookML

Nesta página, mostramos como adicionar e personalizar um elemento de dashboard do LookML de type: looker_waterfall com parâmetros do dashboard do LookML em um arquivo dashboard.lkml.

Para informações sobre como criar um gráfico de cascata na interface do Looker, consulte a página de documentação Opções de gráfico de cascata.

Exemplo de uso

Um N indica que um valor numérico é obrigatório. As aspas simples indicam texto descritivo e não devem ser incluídas no código ativo.


## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_waterfall
height: N
width: N
top: N
left: N
row: N
col: N
refresh: N (seconds | minutes | hours | days)
note_state: collapsed | expanded
note_display: above | below | hover
note_text: 'note text'

## QUERY PARAMETERS
model: model_name
explore: explore_name
fields: [view_name.field_name, view_name.field_name, …]
dimensions: [view_name.field_name, view_name.field_name, …]
measures: [view_name.field_name, view_name.field_name, …]
sorts: [view_name.field_name asc | desc, view_name.field_name, …]
fill_fields: [view_name.field_name, view_name.field_name, …]
limit: N
column_limit: N
filters:
  view_name.field_name: 'Looker filter expression' | 'filter value'
filter_expression:  'Looker custom filter expression'
listen:
  dashboard_filter_name: view_name.field_name
hidden_fields: [view_name.field_name, view_name.field_name, …]
query_timezone: 'specific timezone' | user_timezone
merged_queries:
- 'primary query definition'
- 'next source query definition'
  join_fields:
  - field_name: view_name.field_name
    source_field_name: view_name.field_name

## SERIES PARAMETERS
up_color: "hex string" | 'CSS named color string'
down_color: "hex string" | 'CSS named color string'
total_color: "hex string" | 'CSS named color string'
color_application:
  collection_id: 'collection ID'
  palette_id: 'palette ID'
  options:
    reverse: true | false

## VALUE PARAMETERS
show_value_labels: true | false
label_color: ['color value']

## X-AXIS PARAMETERS
x_axis_scale: auto | ordinal | time
show_x_axis_label: true | false
show_x_axis_ticks: true | false
x_axis_zoom: true | false

## Y-AXIS PARAMETERS
show_y_axis_labels: true | false
show_y_axis_ticks: true | false
y_axis_gridlines: true | false
y_axis_zoom: true | false

## ADVANCED VISUALIZATION CONFIGURATION PARAMETERS
advanced_vis_config: 'Highcharts JSON snippet'

Definições de parâmetro

Nome do parâmetro Descrição
Parâmetros básicos
name (para elementos) Cria o elemento
title (para elementos) Muda a forma como o nome do elemento aparece para os usuários.
type (para elementos) Determina o tipo de visualização a ser usado no elemento.
height (para elementos) Define a altura do elemento em unidades de tile_size para dashboards layout: tile e layout: static.
width (para elementos) Define a largura do elemento em unidades de tile_size para dashboards layout: tile e layout: static.
top Define a posição de cima para baixo do elemento em unidades de tile_size para dashboards layout: static.
left Define a posição da esquerda para a direita do elemento em unidades de tile_size para dashboards layout: static.
row Define a posição de cima para baixo de um elemento em unidades de linhas para dashboards layout: newspaper.
col Define a posição da esquerda para a direita de um elemento em unidades de colunas para dashboards layout: newspaper.
refresh (para elementos) Define o intervalo em que o elemento será atualizado automaticamente.
note_state Define se a observação será recolhida ou expandida se for muito grande para caber em uma única linha dentro da largura do elemento.
note_display Define onde a observação é exibida no elemento.
note_text Especifica o texto mostrado na nota.
Query Parameters
model Define o modelo a ser usado para a consulta do elemento.
explore (para elementos) Define a análise detalhada a ser usada na consulta do elemento.
fields Define os campos a serem usados para a consulta do elemento. Isso pode ser usado no lugar de dimensions e measures.
dimensions Define as dimensões a serem usadas na consulta do elemento.
measures Define as medidas a serem usadas na consulta do elemento.
sorts Define as classificações a serem usadas na consulta do elemento.
fill_fields Define as dimensões que usam a opção preenchimento de dimensão.
limit Define o limite de linhas a ser usado na consulta do elemento.
filters (para elementos) Define os filtros que não podem ser alterados para a consulta do elemento.
filter_expression Define um filtro personalizado que não pode ser alterado para a consulta do elemento.
listen Define os filtros que podem ser alterados para a consulta do elemento, se filters (para painel) tiver sido criado.
hidden_fields Especifica os campos a serem usados na consulta, mas ocultos no gráfico
query_timezone Define o fuso horário que deve ser usado quando a consulta é executada.
merged_queries Define uma consulta de resultados combinados.
Parâmetros de série
up_color Define a cor das barras de valores positivos no gráfico.
down_color Define a cor das barras de valores negativos no gráfico.
total_color Define a cor da barra de valor total no gráfico.
color_application Aplica uma coleção de cores e uma paleta ao gráfico.
Parâmetros de valor
show_value_labels Mostra rótulos para cada barra de dados
label_color Especifica um valor de cor para os rótulos
Parâmetros do eixo X
x_axis_scale Especifica como a escala do eixo x é calculada
show_x_axis_label Mostra ou oculta o rótulo do eixo x.
show_x_axis_ticks Mostra valores no eixo x
x_axis_zoom Especifica se o zoom ao longo do eixo x é permitido.
Parâmetros do eixo Y
show_y_axis_labels Mostra ou oculta o rótulo do eixo y.
show_y_axis_ticks Mostra valores no eixo y
y_axis_gridlines Estende as linhas de grade do eixo y.
y_axis_zoom Especifica se é permitido ampliar ao longo do eixo y. Desativado se x_axis_zoom: false.
Parâmetros de configuração avançada de visualização
advanced_viz_config Aceita um snippet JSON do HighCharts que pode substituir várias configurações de visualização.

Parâmetros básicos

Ao definir um elemento de painel do LookML, você precisa especificar valores para pelo menos os parâmetros básicos name e type. Outros parâmetros básicos, como title, height e width, afetam a aparência e a posição do elemento em um painel.

name

Esta seção se refere ao parâmetro name, que faz parte de um elemento do painel.

name também pode ser usado como parte de um filtro do painel, descrito na página de documentação Parâmetros do painel.

Cada declaração name cria um novo elemento de painel e atribui um nome a ele. Os nomes dos elementos precisam ser exclusivos. Às vezes, os nomes são referenciados no parâmetro elements quando você usa painéis layout: grid.

- name: orders_by_date

title

Esta seção se refere ao parâmetro title, que faz parte de um elemento do painel.

title também pode ser usado como parte de um painel, conforme descrito na página de documentação Parâmetros do painel.

title também pode ser usado como parte de um filtro do painel, descrito na página de documentação Parâmetros do painel.

O parâmetro title permite mudar a forma como o nome de um elemento aparece para os usuários. Se não for especificado, o título vai usar o elemento name como padrão.

Por exemplo,

- name: sales_overview
  title: '1) Sales Overview'

Se você usou esse formato, em vez de aparecer como Visão geral das vendas, o elemento apareceria como 1) Visão geral das vendas.

type

Esta seção se refere ao parâmetro type, que faz parte de um elemento do painel.

type também pode ser usado como parte de um filtro do painel, descrito na página de documentação Parâmetros do painel.

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

type também pode ser usado como parte de uma dimensão, conforme descrito na página de documentação Tipos de dimensões, filtros e parâmetros.

type também pode ser usado como parte de uma métrica, conforme descrito na página de documentação Tipos de métricas.

O parâmetro type determina o tipo de visualização a ser usado no elemento.

- name: element_name
  type: text | looker_grid | table | single_value | looker_single_record |
        looker_column | looker_bar | looker_scatter | looker_line | looker_area |
        looker_pie | looker_donut_multiples | looker_funnel | looker_timeline |
        looker_map | looker_google_map | looker_geo_coordinates | looker_geo_choropleth | looker_waterfall | looker_wordcloud | looker_boxplot

Consulte a página de documentação type (para dashboards do LookML) para uma visão geral dos diferentes tipos de elementos de dashboard do LookML.

height

Esta seção se refere ao parâmetro height, que faz parte de um elemento do painel.

height também pode ser usado como parte de uma linha do painel, conforme descrito na página de documentação Parâmetros do painel.

Para painéis com layouts tile ou static

O parâmetro height define a altura de um elemento, em unidades de tile_size (definido em pixels), para painéis layout: tile e layout: static.

Por exemplo, o código a seguir especifica tile_size: 100 e height: 4, fazendo com que o elemento orders_by_date tenha 400 pixels de altura.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    height: 4
    ...

Para painéis com layout newspaper

O parâmetro height define a altura de um elemento, em unidades de linha, para dashboards layout: newspaper.

Um dashboard com layout de jornal tem uma altura padrão de seis linhas ou cerca de 300 pixels. A altura mínima é de uma linha para painéis com um parâmetro preferred viewer definido como dashboards-next. A altura mínima é de duas linhas para painéis com um parâmetro preferred viewer definido como dashboards.

Por exemplo, o código a seguir define um elemento com 12 linhas de altura, ou seja, o dobro da altura de outros elementos definidos como padrão:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    height: 12
    ...

width

Esta seção se refere ao parâmetro width, que faz parte de um elemento do painel.

width também pode ser usado como parte de um painel, conforme descrito na página de documentação Parâmetros do painel.

O parâmetro width define a largura de um elemento, em unidades de tile_size, para painéis layout: tile e layout: static.

Por exemplo, o código a seguir especifica tile_size: 100 e width: 4, fazendo com que o elemento orders_by_date tenha 400 pixels de largura.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    width: 4
    ...

O parâmetro width define a largura de um elemento, em unidades de colunas, para painéis layout: newspaper.

Um painel com layout de jornal tem uma largura padrão de 24 colunas.

Por exemplo, o código a seguir define o elemento como metade da largura do painel:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    width: 12
    ...

top

O parâmetro top define a posição de cima para baixo de um elemento, em unidades de tile_size, para painéis layout: static.

Por exemplo, o código a seguir especifica tile_size: 100 e top: 4, posicionando a borda superior do elemento orders_by_date a 400 pixels da parte de cima do painel.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    top: 4
    ...

left

O parâmetro left define a posição da esquerda para a direita de um elemento, em unidades de tile_size, para painéis layout: static.

Por exemplo, o código a seguir especifica tile_size: 100 e left: 4, posicionando a borda esquerda do elemento orders_by_date a 400 pixels do lado esquerdo do painel.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    left: 4
    ...

row

Para painéis layout: newspaper, o parâmetro row define a linha em que a borda superior de um elemento é colocada.

Um painel começa com a linha 0 na parte superior. Um dashboard com layout de jornal tem uma altura padrão de seis linhas. Isso significa que os elementos na parte superior de um dashboard (row: 0) ocupam as linhas de 0 a 5.

Cada linha tem 50 pixels de altura, o que significa que a altura padrão do elemento de seis linhas é de 300 pixels.

Por exemplo, o código a seguir define um elemento para ser colocado na segunda linha de elementos no painel, supondo que os elementos estejam definidos na altura padrão:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    row: 6
    ...

col

Para dashboards layout: newspaper, o parâmetro col define a coluna em que a borda esquerda do elemento é colocada.

Os painéis são divididos em 24 colunas. Um painel começa com a coluna 0 à esquerda. Um painel com layout de jornal tem uma largura de elemento padrão de oito colunas. Isso significa que os elementos à esquerda de um painel (col: 0) ocupam as colunas de 0 a 7 por padrão.

Por exemplo, o código a seguir define um elemento para ser definido na terceira coluna de elementos no painel:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    col: 16
    ...

refresh

Esta seção se refere ao parâmetro refresh, que faz parte de um elemento do painel.

refresh também pode ser usado como parte de um painel, conforme descrito na página de documentação Parâmetros do painel.

O parâmetro refresh permite que um elemento seja recarregado automaticamente de forma periódica, recuperando dados atualizados. Isso costuma ser útil em configurações em que um painel é exibido constantemente, como em uma TV de escritório. O painel precisa estar aberto em uma janela do navegador para que esse parâmetro tenha efeito. Essa configuração não é executada em segundo plano para "pré-aquecer" o cache do painel.

A taxa de atualização pode ser qualquer número (sem decimais) de segundos, minutos, horas ou dias. Exemplo:

- name: orders_by_date
  refresh: 2 hours

Tenha cuidado ao definir intervalos de atualização curtos. Se a consulta por trás do elemento exigir muitos recursos, alguns elementos poderão sobrecarregar seu banco de dados mais do que o desejado.

note_state

O parâmetro note_state define se uma observação será recolhida ou expandida se for muito grande para caber em uma única linha dentro da largura do elemento. Se você escolher collapsed e a observação for muito longa, ela vai terminar em reticências clicáveis (...) que podem ser usadas para ler a observação completa. Se você escolher expanded e a observação for longa, ela vai ocupar mais linhas.

note_display

O parâmetro note_display define onde uma nota é exibida em um elemento. above coloca a nota na parte de cima de um elemento, below coloca na parte de baixo, e hover exige que o usuário passe o cursor do mouse sobre um ícone ? para ver a nota.

note_text

O parâmetro note_text especifica o texto mostrado em uma nota de elemento.

Parâmetros de consulta

Ao definir um elemento de painel da LookML, é necessário especificar valores para pelo menos os parâmetros de consulta model e explore. Além disso, pelo menos um campo precisa ser especificado usando o parâmetro dimensions, measures ou fields. Você também pode usar os outros parâmetros de consulta para controlar a forma como os dados são mostrados em um elemento do painel.

model

O parâmetro model define o modelo a ser usado para a consulta de elemento. Se não for especificado, o padrão será o modelo em que o painel reside.

- name: orders_by_date
  model: ecommerce

O parâmetro model aceita constantes do LookML. É possível definir uma constante no arquivo de manifesto do projeto e usar a sintaxe "@{constant_name}" para definir a constante como o valor de model. Usar uma constante permite definir o nome de um modelo em um só lugar, o que é particularmente útil se você estiver atualizando o nome de um modelo usado por vários elementos do painel.

Para mais informações e um exemplo de uso de constantes com painéis do LookML, consulte a página de documentação do parâmetro constant.

explore

Esta seção se refere ao parâmetro explore, que faz parte de um elemento do painel.

explore também pode ser usado como parte de um modelo, descrito na página de documentação do parâmetro explore.

explore também pode ser usado como parte de um filtro do painel, descrito na página de documentação Parâmetros do painel.

O parâmetro explore define a análise detalhada a ser usada para a consulta de elemento.

- name: orders_by_date
  explore: order

O parâmetro explore aceita constantes do LookML. É possível definir uma constante no arquivo de manifesto do projeto e usar a sintaxe "@{constant_name}" para definir a constante como o valor de explore. Usar uma constante permite definir o nome de uma análise detalhada em um só lugar, o que é particularmente útil se você estiver atualizando o nome de uma análise detalhada usada por vários elementos do painel.

Para mais informações e um exemplo de uso de constantes com painéis do LookML, consulte a página de documentação do parâmetro constant.

fields

O parâmetro fields define os campos a serem usados para a consulta de elementos. Use a sintaxe view_name.dimension_name para especificar os campos.

## single field example
- name: orders_by_date
  fields: order.order_date

## multiple fields example
- name: orders_by_date
  fields: [order.order_date, order.order_count]

Se você usar o parâmetro fields, não será necessário usar os parâmetros dimensions e measures.

dimensions

O parâmetro dimensions define a dimensão ou as dimensões a serem usadas na consulta de elemento. Use a sintaxe view_name.dimension_name para especificar a dimensão. Não inclua dimensions se a consulta não tiver nenhum.

## single dimension example
- name: orders_by_date
  dimensions: order.order_date

## multiple dimension example
- name: orders_by_date
  dimensions: [order.order_date, customer.name]

measures

O parâmetro measures define a métrica ou as métricas a serem usadas na consulta de elemento. Use a sintaxe view_name.measure_name para especificar a métrica. Não inclua measures se a consulta não tiver nenhum.

## single measure example
- name: orders_by_date
  measures: order.count

## multiple measure example
- name: orders_by_date
  measures: [order.count, order_item.count]

sorts

O parâmetro sorts define as classificações a serem usadas na consulta de elementos. A classificação principal é listada primeiro, seguida pela secundária e assim por diante. Use a sintaxe view_name.field_name para especificar a dimensão ou a métrica. Não inclua sorts se quiser usar a ordem de classificação padrão do Looker. As classificações em ordem decrescente têm o sufixo desc, e as em ordem crescente não precisam de um sufixo.

## single sort example
- name: orders_by_date
  sorts: order.order_date desc

## multiple sort example
- name: orders_by_date
  sorts: [order.order_date desc, customer.name]

fill_fields

O parâmetro fill_fields define as dimensões que usam a opção preenchimento de dimensão. Use a sintaxe view_name.dimension_name para especificar as dimensões.

- name: orders_by_date
  fill_fields: [orders.created_date, orders.shipped_date]

limit

O parâmetro limit define o limite de linhas que deve ser usado para a consulta de elementos. O limite se aplica ao número de linhas antes da aplicação de qualquer rotação.

- name: orders_by_date
  limit: 100

filters

Esta seção se refere ao parâmetro filters, que faz parte de um elemento do painel.

filters também pode ser usado como parte de um painel, conforme descrito na página de documentação Parâmetros do painel.

filters também pode ser usado como parte de uma métrica, conforme descrito na página de documentação do parâmetro filters.

O parâmetro filters define os filtros não modificáveis que devem ser usados na consulta do elemento. Se você quiser filtros que um usuário possa mudar no painel, configure-os usando filters para painéis e aplique-os aos elementos usando listen.

A sintaxe de filters é:

- name: element_name
  filters:
    orders.created_date: 2020/01/10 for 3 days
    orders.status: Shipped
    # You can create multiple filter statements

Cada filtro pode aceitar uma expressão de filtro do Looker ou uma constante de valor. Também é possível usar as variáveis Liquid _localization ou _user_attributes na expressão de filtro para valores flexíveis.

filter_expression

O parâmetro filter_expression define um filtro personalizado não modificável para a consulta do elemento. Se você quiser filtros que um usuário possa mudar no painel, configure-os usando filters para painéis e aplique-os aos elementos usando listen.

- name: element_name
  filter_expression:
  - diff_days(${users.created_date},${user_order_facts.first_order_date}) > 60

A página de documentação Expressões de filtro do Looker lista as expressões de filtro do Looker.

listen

Com os filtros do painel, os leitores podem refinar de forma interativa os dados mostrados nos elementos do painel. Defina filtros de dashboard com o parâmetro filters para dashboards do LookML. Em seguida, use o parâmetro listen para vincular elementos do painel ao filtro.

A sintaxe de listen é a seguinte:

- name: element_name
  listen:
    filter_name_goes_here: dimension or measure on which to apply
                           the filter using view_name.field_name syntax
    # You can add more than one listen statement

Adicione o parâmetro listen a um elemento e forneça o nome do filtro seguido por dois-pontos e uma referência ao campo em que o filtro deve ser aplicado, usando a sintaxe view_name.field_name. Por exemplo, você pode criar um filtro chamado Data que exige que um usuário insira uma data no campo de filtro da UI. Em seguida, aplique o valor inserido pelo usuário ao elemento orders_by_date desta forma:

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

  elements:
 - name: orders_by_date
    listen:
      date: order.order_date
    ...

Para mais exemplos de como usar os parâmetros filters e listen para aplicar filtros de painel a elementos individuais, consulte Criar painéis do LookML.

hidden_fields

O parâmetro hidden_fields indica quais campos, se houver, são usados na consulta, mas ficam ocultos no gráfico. Todos os campos ocultos vão aparecer na seção de tabela de dados de uma análise detalhada.

hidden_fields: [inventory_items.count, distribution_centers.id]

query_timezone

O parâmetro query_timezone especifica o fuso horário em que a consulta será executada. As opções de fuso horário são mostradas na página de documentação Valores para timezone. Se você quiser que a consulta seja executada usando o fuso horário do leitor, atribua o valor como user_timezone.

- name: orders_by_date
  query_timezone: America/Los Angeles

- name: orders_by_customer
  query_timezone: user_timezone

merged_queries

Com o parâmetro merged_queries, é possível combinar os resultados de várias consultas em um único elemento do painel. Defina cada consulta de origem no parâmetro merged_queries do elemento e use o subparâmetro join_fields para especificar como os resultados devem ser mesclados.

O exemplo de código LookML a seguir cria um elemento de type: looker_grid de resultados combinados. Neste exemplo, o parâmetro merged_queries é usado para criar um elemento de painel que combina dados de duas consultas separadas em um único gráfico de tabela:

- name: merged_results_element
  title: Merged Results Tile
  type: looker_grid
  merged_queries:
  - model: ecommerce
    explore: users
    type: table
    fields: [users.state, users.count, users.city]
    sorts: [users.count desc 0]
    limit: 5000
    column_limit: 50
    query_timezone: UTC
    listen:
    - State: users.state
  - model: ecommerce
    explore: users
    type: table
    fields: [users.state, users.city]
    sorts: [users.state]
    limit: 500
    column_limit: 50
    query_timezone: UTC
    join_fields:
    - field_name: users.state
      source_field_name: users.state
    - field_name: users.city
      source_field_name: users.city
    listen:
    - State: users.state

Neste exemplo, o elemento do painel combina dados de duas consultas de origem baseadas na análise detalhada users no modelo ecommerce. A consulta principal inclui os campos users.state, users.count e users.city e classifica os resultados pelo campo users.count. A segunda consulta de origem inclui os campos users.state e users.city e classifica os resultados pelo campo users.state.

O parâmetro join_field mescla as consultas de origem com base nos valores correspondentes nos campos users.state e users.city.

O parâmetro listen aplica um filtro State às duas consultas, permitindo que os leitores do painel refinem os resultados da consulta mostrados no bloco do painel ao selecionar um estado específico.

Exemplo: como mesclar dados da empresa

Imagine que você queira criar uma consulta mesclada que combine informações sobre empresas de duas Análises diferentes: company_info e companies. Você quer combinar as consultas nos campos ipo.stock_symbol, companies.name e companies.contact_email de cada análise detalhada para criar uma consulta que retorne resultados para nome da empresa, e-mail de contato da empresa, ano da abertura de capital, símbolo da ação, número de funcionários e número de vagas. É possível definir o elemento de consulta mesclada em LookML da seguinte maneira:

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
    filters:
      companies.contact_email: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
  - model: company_data
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.contact_email,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.contact_email: "-NULL"
    sorts: [jobs.job_count desc]
    join_fields:
    - field_name: ipo.stock_symbol
      source_field_name: ipo.stock_symbol
    - field_name: companies.name
      source_field_name: companies.name
    - field_name: companies.contact_email
      source_field_name: companies.contact_email

Aplicar filtros a elementos de consulta combinados

O exemplo anterior de um elemento de consulta mesclada demonstra como aplicar filtros codificados diretamente em cada consulta de origem usando o parâmetro filters. Por exemplo, os filtros companies.contact_email: "-NULL" e ipo.valuation_amount: NOT NULL na consulta principal restringem os resultados a empresas com e-mails de contato e avaliações válidos. Esses filtros pré-filtram os dados antes de mesclar as consultas e não podem ser alterados pelo usuário.

Também é possível aplicar filtros de painel aos elementos de consulta mesclados usando o parâmetro listen na definição de cada consulta de origem. Por exemplo, suponha que você tenha um filtro de dashboard chamado Industry definido no nível do dashboard usando o parâmetro filters para dashboards da LookML:

filters:
- name: Industry
  title: Industry
  type: field_filter
  ui_config:
    type: dropdown_menu
    display: inline
  model: market_research
  explore: company_info
  field: companies.industry

Para aplicar o filtro Industry ao campo companies.industry nas duas consultas de origem, adicione o parâmetro listen a cada uma das definições de consulta de origem da consulta mesclada da seguinte maneira:

listen:
  Industry: companies.industry

Por exemplo, o código de amostra a seguir adiciona o filtro Industry às duas consultas de origem no elemento de resultados mesclados do exemplo anterior.

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
    filters:
      companies.contact_email: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
    listen:
      Industry: companies.industry
  - model: company_data
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.contact_email,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.contact_email: "-NULL"
    sorts: [jobs.job_count desc]
    join_fields:
    - field_name: ipo.stock_symbol
      source_field_name: ipo.stock_symbol
    - field_name: companies.name
      source_field_name: companies.name
    - field_name: companies.contact_email
      source_field_name: companies.contact_email
    listen:
      Industry: companies.industry

Com essa adição, quando um usuário interage com o filtro do painel Industry, a consulta de origem correspondente no elemento de consulta mesclada é filtrada de acordo.

Parâmetros de série

Os parâmetros descritos nesta seção correspondem às opções do menu Série do editor de visualização para gráficos de cascata.

up_color

Defina a cor das barras de valores positivos no gráfico. O valor da cor pode usar uma string hexadecimal entre aspas, como "#2ca6cd", ou uma string de cor nomeada em CSS, como mediumblue.

up_color: blue

O parâmetro up_color substitui o parâmetro color_application, se ele for usado.

down_color

Defina a cor das barras de valores negativos no gráfico. O valor da cor pode usar uma string hexadecimal entre aspas, como "#2ca6cd", ou uma string de cor nomeada em CSS, como mediumblue.

down_color: "#ff0000"

O parâmetro down_color substitui o parâmetro color_application, se ele for usado.

total_color

Defina a cor da barra de valor total no gráfico. O valor da cor pode usar uma string hexadecimal entre aspas, como "#2ca6cd", ou uma string de cor nomeada em CSS, como mediumblue.

total_color: yellow

O parâmetro total_color substitui o parâmetro color_application, se ele for usado.

color_application

O parâmetro color_application e os subparâmetros collection_id e palette_id podem ser usados para aplicar uma coleção e uma paleta de cores específicas a um elemento do painel. Para uma visão geral das coleções de cores nativas do Looker, consulte a página de documentação Coleções de cores.

Se você tiver o ID da coleção e o ID da paleta que quer usar, insira esses IDs nos subparâmetros collection_id e palette_id. Um ID de coleção ou de paleta pode ser um código alfanumérico ou ter como base o nome da coleção de cores. Os códigos alfanuméricos são usados para as coleções nativas do Looker. Elas são específicas da instância e têm esta aparência:


color_application:
  collection_id: 1297dk12-86a7-4xe0-8dfc-82de20b3806a
  palette_id: 93c8aeb7-3f8a-4ca7-6fee-88c3617516a1

As coleções de cores personalizadas usam IDs de coleção e paleta com base no nome da coleção de cores, que são portáteis entre instâncias e têm esta aparência:


color_application:
  collection_id: blue-tone-collection
  palette_id: blue-tone-collection-categorical-0

Você também pode usar a UI para encontrar as cores, coleções ou paletas que quer e gerar a LookML para adicioná-las ao painel. Navegue até um conteúdo definido pelo usuário (como um Look, um painel ou uma análise detalhada) e aplique as cores, a coleção ou a paleta que você quer à visualização desse conteúdo usando a UI. Depois disso, siga as etapas para receber o LookML do painel, copie o LookML produzido e cole-o na seção color_application.

color_application e as barras de valor positivo, negativo e total

Por padrão, a primeira cor da paleta designada é aplicada às barras de valores positivos no gráfico de cascata, a segunda cor é aplicada às barras negativas e a terceira cor é aplicada à barra de total. O subparâmetro opcional reverse muda a aplicação para a última cor, a penúltima cor e a antepenúltima cor, respectivamente.

color_application:
  collection_id: blue-tone-collection
  palette_id: blue-tone-collection-categorical-0
  options:
    reverse: true

Os parâmetros up_color, down_color e total_color substituem todas as cores designadas no parâmetro color_application, se os dois tipos de parâmetros de cor forem usados.

Parâmetros de valor

Os parâmetros descritos nesta seção correspondem às opções do menu Valores do editor de visualização para gráficos de cascata.

show_value_labels

Mostra o valor de uma barra, linha ou ponto ao lado do ponto de dados.

show_value_labels: true | false

## default value: false

label_color

O parâmetro label_color aceita um valor de cor para os rótulos. O valor da cor pode ser formatado como uma string hexadecimal, como #2ca6cd, ou como uma string de cor nomeada em CSS, como mediumblue.


label_color: [blue]

Parâmetros do eixo X

Os parâmetros descritos nesta seção correspondem às opções no menu X do editor de visualização para gráficos de cascata.

x_axis_scale

Esse parâmetro determina como a escala do eixo x é calculada.

  • auto: a escala será inferida com base nos dados. Esta é a configuração padrão.
  • ordinal: os dados serão representados como entradas discretas e com espaçamento uniforme.
  • time: os dados serão representados como tempo, e o eixo será rotulado adequadamente. Isso não vai funcionar se os dados não puderem ser convertidos em datas.
x_axis_scale: auto | ordinal | time

## default value: auto

show_x_axis_label

Esse parâmetro determina se o rótulo do eixo x é mostrado.

show_x_axis_label: true | false

## default value: true

show_x_axis_ticks

Esse parâmetro determina se os valores são mostrados no eixo x.

show_x_axis_ticks: true | false

## default value: true

x_axis_zoom

Esse parâmetro especifica se os usuários podem ampliar o eixo x da visualização. Quando x_axis_zoom está definido como true, o zoom está disponível. Quando x_axis_zoom é definido como false, o zoom não está disponível.

Se x_axis_zoom estiver definido como false, y_axis_zoom será desativado.

x_axis_zoom: true | false

# default value: true

Parâmetros do eixo Y

Os parâmetros descritos nesta seção correspondem às opções do menu Y do editor de visualização para gráficos de cascata.

show_y_axis_labels

Esse parâmetro determina se o rótulo do eixo y é mostrado.

show_y_axis_labels: true | false

## default value: true

show_y_axis_ticks

Esse parâmetro determina se os valores são mostrados no eixo y.

show_y_axis_ticks: true | false

## default value: true

y_axis_gridlines

Esse parâmetro determina se as linhas de grade são estendidas do eixo y.

y_axis_gridlines: true | false

## default value: true

y_axis_zoom

Esse parâmetro especifica se os usuários podem ampliar o eixo y da visualização. Quando y_axis_zoom está definido como true, o zoom está disponível.

Quando y_axis_zoom é definido como false, os usuários não podem ampliar partes menores do eixo y. No entanto, os usuários ainda podem ampliar partes menores do eixo x se o parâmetro x_axis_zoom estiver definido como true.

Se x_axis_zoom estiver definido como false, y_axis_zoom será desativado.

y_axis_zoom: true | false

# default value: true

Configuração avançada de visualização

Os parâmetros descritos nesta seção correspondem às substituições opcionais de configuração de gráfico, que podem ser aplicadas a um gráfico clicando no botão Editar configuração do gráfico na seção Plotar do editor de visualização.

advanced_vis_config

Esse parâmetro aceita um snippet JSON do HighCharts que substitui várias configurações de visualização e abre novas possibilidades. Consulte a página de documentação Personalizar visualizações usando o editor de configuração de gráficos para ver exemplos de como usar o JSON do HighCharts para alcançar casos de uso comuns.


advanced_vis_config: "{ series: [{ formatters: [{ select: 'value >= 50', style: { color: 'orange' } }]}]}"

# This example changes the color to orange for any series value that is greater than or equal to 50.

# default value: null