Parâmetros de gráficos de tabela para dashboards do LookML

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

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

Exemplo de uso


## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_grid
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, …]
pivots: [view_name.field_name, view_name.field_name, …]
fill_fields: [view_name.field_name, view_name.field_name, …]
subtotals: [view_name.field_name, view_name.field_name, …]
total: true | false
row_total: right | left | false
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
query_timezone: 'specific timezone' | user_timezone
analysis_config: # can only be used when the Forecasting Labs feature is enabled
  forecasting:
  - confidence_interval: N
    field_name: view_name.field_name
    forecast_n: N
    forecast_interval: day | month | a time frame with dimension fill
    seasonality: N
merged_queries:
- 'primary query definition'
- 'next source query definition'
  join_fields:
  - field_name: view_name.field_name
    source_field_name: view_name.field_name

## COLUMN PARAMETERS
auto_size_all_columns: true | false
column_order: [view_name.field_name, view_name.field_name, …]
pinned_columns:
    view_name.field_name: left

## PLOT PARAMETERS
table_theme: editable | white | gray | transparent | unstyled
show_row_numbers: true | false
hide_totals: true | false
hide_row_totals: true | false
transpose: true | false
hidden_fields: [view_name.field_name, view_name.field_name, …]
limit_displayed_rows: true | false
limit_displayed_rows_values:
  show_hide: show | hide
  first_last: first | last
  num_rows: 'N'

## SERIES PARAMETERS
truncate_text: true | false
show_view_names: true | false
size_to_fit: true | false
dynamic_fields:
- table_calculation: {'table calculation definition'}
- measure: {'custom measure or custom filtered measure definition'}
- dimension: {'custom dimension definition'}
series_labels:
    view_name.field_name: 'Series Label'
series_column_widths:
    view_name.field_name: N
series_cell_visualizations:
    view_name.field_name:
        is_active: true | false
        palette:
            palette_id: 'palette ID'
            collection_id: 'collection ID'
            custom_colors:
            - 'color value'
        value_display: true | false
series_text_format:
    view_name.field_name:
        fg_color: 'color value'
        bg_color: 'color value'
        bold: true | false
        italic: true | false
        align: left | center | right
series_collapsed:
    view_name.field_name: true | false
series_value_format:
    view_name.field_name:
        format_string: 'value formatting string'

## FORMATTING PARAMETERS
color_application:
    collection_id: 'collection ID'
    palette_id: 'palette ID'
header_font_color: 'color value'
header_background_color: 'color value'
header_text_alignment: left | center | right
header_font_size: N
rows_font_size: N
enable_conditional_formatting: true | false
conditional_formatting_include_totals: true | false
conditional_formatting_include_nulls: true | false
conditional_formatting:
  {'desired conditional formatting'}

Definições de parâmetro

Nome do parâmetro Descrição
Parâmetros básicos
name (para elementos) Cria um elemento.
title (para elementos) Muda a forma como o nome de um 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 de um elemento em unidades de tile_size para dashboards layout: tile e layout: static.
width (para elementos) Define a largura de um elemento em unidades de tile_size para dashboards layout: tile e layout: static.
top Define a posição de cima para baixo de um elemento em unidades de tile_size para dashboards layout: static.
left Define a posição da esquerda para a direita de um 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 nota aparece em um elemento.
note_text Especifica o texto que aparece 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.
pivots Define as dimensões que precisam ser transformadas em pivô para serem usadas na consulta do elemento.
fill_fields Define as dimensões que usam a opção preenchimento de dimensão.
subtotals Define os campos que são subtotais
total Especifica se os totais de colunas são mostrados em uma visualização de tabela.
row_total Especifica se os totais das linhas são mostrados em uma visualização de tabela.
limit Define o limite de linhas a ser usado na consulta do elemento.
column_limit Define o limite de colunas 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.
query_timezone Define o fuso horário que deve ser usado quando a consulta é executada.
analysis_config Adicionado na versão 21.14 Define a análise de previsão que deve ser realizada quando a consulta é executada. É necessário ativar o recurso de laboratório Previsão.
merged_queries Define uma consulta de resultados combinados.
Parâmetros de coluna
auto_size_all_columns Dimensiona automaticamente cada coluna da tabela para a largura do cabeçalho ou do maior valor de dados, o que for maior.
column_order Ordena as colunas no gráfico de tabela.
pinned_columns Define as colunas a serem fixadas ou congeladas no lado esquerdo do gráfico de tabela.
Parâmetros de plotagem
table_theme Aplica uma das cinco opções de coloração a uma visualização de tabela.
show_row_numbers Define se um número de linha vai aparecer no início de cada linha da tabela.
hide_totals Define se uma visualização de tabela mostra os totais das colunas.
hide_row_totals Define se uma visualização de tabela mostra os totais das linhas.
transpose Define se as linhas da tabela serão transpostas em colunas.
hidden_fields Especifica os campos a serem usados na consulta, mas ocultos no gráfico
limit_displayed_rows Mostra ou oculta linhas em uma visualização com base na posição delas nos resultados.
Parâmetros de série
truncate_text Encurta cabeçalhos de coluna e texto dentro de células de dados com uma reticência (…)
show_view_names Mostra o nome da visualização e o nome do campo para cada cabeçalho de coluna
size_to_fit Dimensiona automaticamente as larguras de todas as colunas para que a tabela se ajuste perfeitamente à largura do elemento em que está sendo visualizada.
dynamic_fields Incluir cálculos de tabela ou campos personalizados no gráfico de tabela
series_labels Especifica um marcador personalizado para cada coluna na visualização.
series_column_widths Especifica larguras específicas para colunas na visualização
series_cell_visualizations Especifica se as colunas usam a opção de visualização Visualização de célula. Esse parâmetro tem os subparâmetros is_active, palette e value_display.
series_text_format Especifica o layout do texto da célula para cada coluna. Esse parâmetro tem os subparâmetros fg_color, bg_color, bold, italic e align.
series_collapsed Especifica se uma coluna com subtotais vai aparecer contraída
series_value_format Define o formato de valor de uma coluna usando a formatação personalizada.
Parâmetros de formatação
color_application Aplica cores às visualizações de células e à formatação condicional
header_font_color Aplica uma cor de fonte aos cabeçalhos de coluna
header_background_color Aplica uma cor aos planos de fundo dos cabeçalhos de coluna.
header_text_alignment Aplica alinhamento à esquerda, à direita ou central aos cabeçalhos de coluna
header_font_size Aplica um tamanho de fonte aos cabeçalhos de coluna
rows_font_size Aplica um tamanho de fonte ao texto dentro das células de dados
enable_conditional_formatting Defina como true para definir regras de classificação por cores em uma visualização de tabela.
conditional_formatting_include_totals Especifica se os totais estão incluídos no esquema de codificação por cores
conditional_formatting_include_nulls Especifica se os valores nulos devem ser representados como zero
conditional_formatting Usa conditional_formatting e os subparâmetros dele para definir as regras que atribuem cores à visualização de tabela.

Parâmetros básicos

Ao definir um elemento de painel do LookML, você precisa especificar valores para pelo menos os parâmetros name e type. Outros parâmetros básicos, como title, height e width, afetam a posição e a aparência de um 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 descritos nesta seção 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]

pivots

O parâmetro pivots define as dimensões que precisam ser usadas como pivô na consulta de elemento. Use a sintaxe view_name.dimension_name para especificar a dimensão. Não inclua pivots se a consulta não tiver nenhum.

## single pivot example
- name: orders_by_date
  pivots: customer.gender

## multiple pivot example
- name: orders_by_date
  pivots: [customer.gender, customer.age_tier]

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]

subtotals

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

subtotals: [products.department, distribution_centers.name]

total

O parâmetro total define se uma linha de totais é mostrada na parte de baixo da tabela. Consulte Como mostrar totais para mais informações.

total: true | false

## default value: false

row_total

O parâmetro row_total define se uma coluna de totais é mostrada à direita ou à esquerda da tabela. Só funciona se houver um pivô. Consulte Como mostrar totais para mais informações.

row_total: right | left | false

## default value: false

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

column_limit

O parâmetro column_limit define o limite de colunas que deve ser usado para a consulta de elementos. O limite se aplica ao número de colunas depois que todos os pivôs são aplicados.

- name: orders_by_date
  column_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.

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

analysis_config

O parâmetro analysis_config e os subparâmetros dele descrevem qualquer análise de consulta a ser usada com a visualização, começando no Looker 21.14. O recurso de laboratório Previsão precisa estar ativado para realizar análises em visualizações.

Os seguintes subparâmetros podem ser usados para definir análises:

É possível criar uma previsão usando uma sintaxe como esta:


  analysis_config:
    - forecasting:
      confidence_interval: 0.95
      field_name: orders.count
      forecast_n: 14
      forecast_interval: day
      seasonality: 7

forecasting

forecasting é um tipo de análise que aplica uma previsão a uma visualização. Com a previsão, os analistas podem adicionar rapidamente projeções de dados a consultas do recurso Detalhar novas ou atuais para ajudar os usuários a prever e monitorar pontos de dados específicos.

Para mais informações, consulte a página de documentação Previsão em visualizações.

Para adicionar previsões às visualizações, o recurso de laboratório Previsão precisa estar ativado.

confidence_interval

confidence_interval define os limites dos valores de dados previstos, que são inseridos como expressões decimais de porcentagens. confidence_interval é opcional e fica em branco por padrão.


confidence_interval: 0.99 | 0.98 | 0.95 | 0.90 | 0.80

Consulte a seção Intervalo de previsão na página de documentação Previsão em visualizações.

Para adicionar previsões às visualizações, o recurso de laboratório Previsão precisa estar ativado.

field_name

field_name especifica os nomes das métricas (até cinco) a serem incluídas nas previsões.


field_name: view_name.field_name

forecast_n

forecast_n especifica a duração da previsão.


forecast_n: N # An integer that represents the length of the forecast

Consulte a seção Período na página de documentação Previsão em visualizações.

Para adicionar previsões às visualizações, o recurso de laboratório Previsão precisa estar ativado.

forecast_interval

forecast_interval define o intervalo de duração para a previsão de valores de dados. forecast_interval é preenchido automaticamente com base na dimensão de período na consulta de análise detalhada.


forecast_interval: day | month # a timeframe with dimension fill

Consulte a página de documentação Length.

Para adicionar previsões às visualizações, o recurso de laboratório Previsão precisa estar ativado.

seasonality

Com seasonality, os analistas podem considerar ciclos conhecidos ou tendências de dados repetitivas em uma previsão. seasonality é opcional e fica em branco por padrão.


seasonality: N # An integer that represents the number of rows over which a cycle or pattern repeats

A configuração de sazonalidade Automática é representada como um valor seasonality em branco.

Consulte a seção Sazonalidade na página de documentação Previsão em visualizações.

Para adicionar previsões às visualizações, o recurso de laboratório Previsão precisa estar ativado.

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 coluna

Os parâmetros a seguir correspondem à capacidade de mover e fixar colunas em gráficos de tabela.

auto_size_all_columns

O parâmetro auto_size_all_columns dimensiona automaticamente cada coluna da tabela para a largura do cabeçalho ou do valor de dados mais longo, o que for maior. Esse parâmetro substitui os parâmetros series_column_widths e size_to_fit, se eles estiverem definidos.

- name: orders_by_date
  auto_size_all_columns: true

column_order

O parâmetro column_order define a ordem das colunas no gráfico de tabela.

- name: orders_by_date
  column_order: [customer.city, customer.state, customer.count]

pinned_columns

O parâmetro pinned_columns define as colunas fixadas à esquerda do gráfico de tabela.

- name: orders_by_date
  pinned_columns:
    orders.created_date: left
    distribution_centers.name: left

Parâmetros de plotagem

Os parâmetros a seguir correspondem às opções no menu Plotar do editor de visualização para gráficos de tabela.

table_theme

Use o parâmetro table_theme para aplicar uma das seguintes opções de coloração a um elemento de tabela:

  • editable: a tabela tem dimensões azuis, medidas laranjas e cálculos de tabela verdes.
  • white: o cabeçalho da tabela é branco, as linhas de dados alternam entre branco e cinza, e o texto é preto.
  • gray: o cabeçalho da tabela é cinza, as linhas de dados alternam entre branco e cinza claro, e o texto é cinza escuro.
  • transparent: o cabeçalho da tabela é totalmente transparente, as linhas de dados alternam entre totalmente transparente e cinza translúcido, e a cor do texto se ajusta de preto para branco conforme necessário, de acordo com a cor de plano de fundo que aparece. Definir table_theme como transparent pode ser útil quando você usa um painel incorporado personalizado para que a cor de plano de fundo do bloco apareça na visualização.
  • unstyled: o cabeçalho da tabela e as linhas de dados são brancos, e o texto é preto.

table_theme: editable | white | gray | transparent | unstyled

show_row_numbers

O parâmetro show_row_numbers define se um número de linha será exibido no início de cada linha da tabela.


show_row_numbers: true | false

hide_totals

Se a análise detalhada incluir totais de colunas, hide_totals vai definir se a visualização mostra os totais.


hide_totals: true | false

hide_row_totals

Se a análise detalhada incluir totais de linhas, hide_row_totals vai definir se eles serão mostrados na visualização.


hide_row_totals: true | false

transpose

Com o parâmetro transpose, é possível transpor linhas de tabela em colunas. Ele aceita true ou false.

- name: orders_by_date
  transpose: true

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]

limit_displayed_rows

Com o parâmetro limit_displayed_rows, é possível mostrar ou ocultar linhas em uma visualização com base na posição delas nos resultados. Por exemplo, se a visualização mostrar uma média móvel de 7 dias, talvez seja melhor ocultar as primeiras seis linhas. Definir como true permite especificar os valores e as posições na visualização a que isso se aplica usando o parâmetro limit_displays_rows_values e os subparâmetros dele.

limit_displayed_rows: true
limit_displayed_rows_values:
  show_hide: hide | show
  first_last: first | last
  num_rows: '10'

limit_displayed_rows_values

Use o parâmetro limit_displayed_rows_values e os subparâmetros show_hide, first_last e num_rows com limit_displayed_rows para especificar quais linhas mostrar ou ocultar em uma visualização. Consulte a seção limit_displayed_rows para exemplos de uso.

show_hide

O subparâmetro show_hide define se algumas linhas serão ocultadas da visualização. Defina show_hide como show para mostrar apenas um número limitado de linhas na visualização e defina show_hide como hide para excluir determinadas linhas da visualização.

first_last

O subparâmetro first_last define se as linhas a serem ocultadas ou mostradas serão as primeiras ou as últimas no conjunto de resultados. Definir first_last como first mostra ou oculta as primeiras linhas, enquanto definir first_last como last mostra ou oculta as últimas linhas.

num_rows

O subparâmetro num_rows define o número de linhas a serem ocultadas ou mostradas. Por exemplo, num_rows: '10' mostra ou oculta as 10 primeiras ou últimas linhas do conjunto de resultados da visualização.

Parâmetros de série

Os parâmetros a seguir correspondem às opções no menu Série do editor de visualização para gráficos de tabela.

truncate_text

O parâmetro truncate_text define se os cabeçalhos de coluna e o texto dentro das células de dados devem ser abreviados com reticências (...).


truncate_text: true | false

show_view_names

O parâmetro show_view_names determina se os nomes das visualizações são mostrados nos rótulos dos gráficos, como nomes de eixos e de colunas.

show_view_names: true | false

## default value: true

size_to_fit

O parâmetro size_to_fit define se as larguras de todas as colunas devem ser dimensionadas para que a tabela se ajuste perfeitamente à largura do elemento em que está sendo exibida. Se o parâmetro auto_size_all_columns estiver definido como true, ele vai substituir size_to_fit.


size_to_fit: true | false

dynamic_fields

O parâmetro dynamic_fields e os subparâmetros dele descrevem cálculos de tabela ou campos personalizados a serem usados com a visualização. É necessário ter permissão para criar campos personalizados e adicionar um description de até 255 caracteres ou usar calculation_type para grupos personalizados ou agrupamentos personalizados. Você precisa ter permissão para criar cálculos de tabela e adicionar um description de até 255 caracteres a eles ou usar calculation_type para cálculos de atalho.

Os seguintes subparâmetros podem ser usados para definir campos dinâmicos:

É possível criar um cálculo de tabela usando uma sintaxe como esta:

dynamic_fields:
  - table_calculation: running_total
    label: Running Total of Items
    expression: running_total(${inventory_items.count})
    value_format_name: decimal_0
    description: your description of up to 255 characters here
    _kind_hint: measure
    _type_hint: number
    is_disabled: false

É possível criar cálculos de atalho para vários tipos de cálculo usando uma sintaxe como esta:

dynamic_fields:
- category: table_calculation
  description: your description of up to 255 characters here
  label: Percent of Orders Count
  value_format:
  value_format_name: percent_0
  calculation_type: percent_of_column_sum
  table_calculation: percent_of_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Percent of previous - Orders Count
  value_format:
  value_format_name: percent_0
  calculation_type: percent_of_previous
  table_calculation: percent_of_previous_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Percent change from previous - Orders Count
  value_format:
  value_format_name: percent_0
  calculation_type: percent_difference_from_previous
  table_calculation: percent_change_from_previous_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Rank of Orders Count
  value_format: ## this field is optional
  value_format_name: ## this field is optional
  calculation_type: rank_of_column
  table_calculation: rank_of_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Running total of Orders Count
  value_format: ## this field is optional
  value_format_name: ## this field is optional
  calculation_type: running_total
  table_calculation: running_total_of_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number

É possível criar uma medida personalizada para usar na visualização com uma sintaxe como esta:

dynamic_fields:
  - measure: avg_sale_price
    label: Average Sale Price
    based_on: products.sale_price
    type: average
    value_format_name: usd
    description: your description of up to 255 characters here
    _kind_hint: measure
    _type_hint: number

Você pode criar uma medida personalizada filtrada para usar na sua visualização com uma sintaxe como esta:

dynamic_fields:
  - measure: order_count_for_25_47_year_olds
    based_on: order_items.order_count
    type: count_distinct
    label: Order Count for 25- to 47-Year-Olds
    description: your description of up to 255 characters here
    value_format: 00#
    _kind_hint: measure
    _type_hint: number
    filter_expression: "${users.age} >= 25 AND ${users.age} <= 47"

Você pode criar uma dimensão personalizada para usar na visualização com uma sintaxe como esta:

dynamic_fields:
  - dimension: user_city_state
    label: User City and State
    expression: concat(${users.city}, ", ", ${users.state})
    description: your description of up to 255 characters here
    _kind_hint: dimension
    _type_hint: string

Você pode criar grupos personalizados para uma dimensão e usar na sua visualização com uma sintaxe como esta:

  - category: dimension
  description: 'States by region'
  label: State Groups
  value_format: ## this field is optional
  value_format_name: ## this field is optional
  calculation_type: group_by
  dimension: state_groups
  args:
  - users.state
  - - label: Pacific Northwest
      filter: Oregon,Idaho,Washington
  - Other
  _kind_hint: dimension
  _type_hint: string

É possível criar agrupamentos personalizados para uma dimensão e usar na visualização com uma sintaxe como esta:

- category: dimension
  description: Order item sale prices, in tiers of 10
  label: Sale Price Bins
  value_format:
  value_format_name:
  calculation_type: bin
  dimension: sale_price_bins
  args:
  - order_items.sale_price
  - '10'
  - '0'
  - '100'
  -
  - classic
  _kind_hint: dimension
  _type_hint: string

É possível adicionar vários campos dinâmicos ao elemento. Não é necessário adicionar cálculos de tabela ao parâmetro fields para que eles apareçam na visualização, mas é preciso adicionar outros tipos de campos dinâmicos a fields para que eles apareçam.

table_calculation

Se você estiver definindo um cálculo de tabela, o subparâmetro table_calculation vai nomear o cálculo. Esse é o nome que você vai usar quando fizer referência ao cálculo da tabela em LookML.

measure

O subparâmetro measure define o nome de uma métrica personalizada ou filtrada. Esse é o nome usado para referenciar a métrica na LookML.

dimension

O subparâmetro dimension define o nome de uma dimensão personalizada. É o nome usado para referenciar a dimensão no LookML.

label

O subparâmetro label define o título do campo dinâmico como você quer que ele apareça na visualização. Pode ser igual ou diferente do nome fornecido nos subparâmetros table_calculation, measure ou dimension.

based_on

Se você estiver usando uma métrica personalizada ou uma métrica personalizada filtrada, o subparâmetro based_on vai identificar a métrica em que ela se baseia, usando a sintaxe view_name.field_name.

type

Se você estiver usando uma métrica personalizada, o subparâmetro type vai identificar o tipo de agregação. Ele aceita count_distinct, sum, average, min, max ou median.

description

É possível adicionar uma descrição de até 255 caracteres a qualquer campo personalizado ou cálculo de tabela com o subparâmetro description. O Looker mostra a descrição quando o usuário clica no ícone de informações à direita do nome do campo no seletor de campos e quando passa o cursor sobre o nome da coluna em uma tabela ou visualização de gráfico de tabela em uma análise detalhada, um painel ou um Look.

expression

Se você estiver usando um cálculo de tabela, o subparâmetro expression definirá a expressão do Looker usada para criar o cálculo.

filter_expression

Se você estiver usando uma métrica filtrada personalizada, o subparâmetro filter_expression definirá a expressão do Looker usada para filtrar a métrica.

value_format

O subparâmetro opcional value_format define o formato do valor de um campo dinâmico quando você usa a formatação personalizada. Se você quiser usar um formato padrão do Looker, use value_format_name.

value_format_name

O subparâmetro opcional value_format_name aplica um formato padrão ao campo dinâmico. Se você quiser usar um formato personalizado, use value_format.

calculation_type

O subparâmetro calculation_type define o tipo de função Cálculo rápido ou Grupo para criar um cálculo de tabela ou um grupo personalizado para uma dimensão:

Opções de calculation_type campos personalizados:

  • group_by: agrupa valores de dimensão em rótulos fixos personalizados com base em uma condição personalizada especificada. Semelhante a CASE WHEN em SQL ou ao parâmetro de campo case do LookML.
  • bin: agrupa valores em classes ou níveis personalizados para dimensões numéricas e personalizadas. Semelhante ao tipo de dimensão tier do LookML.

Opções de calculation_type para cálculos de tabela:

  • percent_of_column_sum: um valor de linha dividido pela soma dos valores na coluna. Esse cálculo inclui apenas os valores que estão na tabela de dados quando o limite de linhas da consulta é atingido.
  • percent_of_previous: o valor da linha atual dividido pelo valor da linha seguinte.
  • percent_difference_from_previous: a diferença entre o valor da linha atual e o valor da linha seguinte, dividida pelo valor da linha seguinte.
  • rank_of_column: a classificação do valor de uma linha entre todos os valores na coluna. Esse cálculo inclui apenas os valores que estão na tabela de dados quando o limite de linhas da consulta é atingido.
  • running_total: a soma cumulativa do valor da linha atual e de todos os valores de linha anteriores na coluna.
  • percent_of_previous_column: para campos dinâmicos, é o valor da coluna atual dividido pelo valor da coluna à esquerda.
  • percent_change_from_previous_column: para campos dinâmicos, é a diferença entre o valor da coluna atual e o valor da coluna à esquerda, dividido pelo valor da coluna à esquerda.
  • percent_of_row: para campos dinâmicos, é a porcentagem do valor da coluna atual dividida pela soma das linhas desse campo.
  • running_row_total: para campos dinâmicos, é a soma cumulativa da coluna atual e de todas as colunas anteriores nesta linha.

args para grupos personalizados

Se você estiver usando grupos personalizados para uma dimensão, args vai especificar os argumentos para aplicar rótulos fixos aos valores de dimensão. args tem o seguinte formato:

args:
- view_name.field_name
  - label: specified custom label
    filter: condition for values
  - label: another specified custom label
    filter: a different condition for values
- Other ## An optional customizable group label for values that do not meet specified conditions.

Você pode adicionar quantas condições label e filter forem necessárias, dependendo do número de grupos desejados.

Consulte o exemplo anterior para referência.

args para agrupamentos personalizados

Se você estiver usando agrupamentos personalizados para uma dimensão numérica, args especificará os argumentos para aplicar níveis fixos aos valores da dimensão. args tem o seguinte formato:

  args:
  - view_name.field_name
  - bin_size ## The numeric interval on which to base each bin, in single quotes
  - min ## The numeric value of the minimum bin size, in single quotes
  - max ## The numeric value of the maximum bin size, in single quotes
  - override ## A value will only appear when a custom bin uses a Custom-sized bin type.
  - style ## The bin display style. Currently, only classic is supported.

Consulte o exemplo anterior para referência.

args para cálculos de atalho

O subparâmetro args é onde você especifica os nomes dos campos numéricos que está usando para um cálculo rápido. Um argumento tem o seguinte formato:

- args:
  - view_name.field_name   ## the field on which the calculation is based

Consulte o exemplo anterior para referência.

_kind_hint

O subparâmetro _kind_hint opcional identifica se o campo dinâmico retorna uma dimensão ou uma medida. Ele aceita os valores dimension e measure.

_type_hint

O subparâmetro opcional _type_hint identifica o tipo de dados que a expressão do campo dinâmico deve gerar.

is_disabled

O subparâmetro opcional is_disabled especifica se um cálculo de tabela aparece na visualização e na análise detalhada associada. Ele aceita os valores true e false.

series_labels

Defina os rótulos de uma ou mais séries com base no nome delas usando pares name: label.

Para um gráfico dinâmico, os nomes das séries são os nomes da dinâmica.

series_labels:
  'Yes': iOS Users
  'No': Android Users

Para um gráfico com várias métricas, os nomes das séries são os nomes dos campos de métricas.

series_labels:
  inventory_items.count: Inventory
  orders.count: Orders

series_column_widths

Defina as larguras de uma ou mais colunas com base no nome da série. Se o parâmetro auto_size_all_columns estiver definido como true, ele vai substituir series_column_widths.

series_column_widths:
  order_times.shipping_time: 50
  orders.count: 60

series_cell_visualizations

Especifique se uma ou mais colunas usam a opção Visualização de célula indicando o nome da série no formato view_name.field_name. series_cell_visualizations tem os subparâmetros is_active, palette e value_display.

series_cell_visualizations:
  order_items.count:
    is_active: true
    palette:
      palette_id: my-custom-colors-sequential-0
      collection_id: my-custom-colors
    value_display: true

is_active

O subparâmetro opcional is_active aceita true ou false para indicar se as visualizações de barras estão ativadas para essa série. Se is_active não for definido, o padrão será true.

palette

O subparâmetro palette é opcional. Se não for usado, a paleta será definida como uma paleta divergente na coleção de cores padrão da instância.

Se palette for usado, os parâmetros filhos palette_id e collection_id vão aplicar as cores de uma paleta específica às visualizações de barras. Para palette_id, use o ID de uma paleta sequencial ou divergente. Para mais informações sobre IDs de paleta e de coleção de cores, consulte a seção color_application.

palette tem um parâmetro filho alternativo, custom_colors, que define de duas a cinco cores personalizadas para usar nas barras:

series_cell_visualizations:
  order_items.count:
    palette:
      custom_colors:
      - orange
      - "#0000ff"
      - red

value_display

O subparâmetro opcional value_display aceita true ou false para indicar se os valores de cada célula de dados são mostrados junto com a visualização da célula. Se value_display não for definido, o padrão será true.

series_text_format

O parâmetro series_text_format e os subparâmetros dele especificam o layout do texto da célula para cada coluna. A série a ser formatada é indicada usando a sintaxe view_name.field_name, e os subparâmetros descrevem a formatação.

Todos os subparâmetros são opcionais. Use apenas os que você precisa.

  series_text_format:
    order_items.shipping_time:
      align: right
    order_items.shipped_date:
      align: center
      fg_color: "#EA8A2F"
      bg_color: "#64518A"
      bold: true
      italic: true

fg_color

O subparâmetro fg_color indica a cor da fonte do texto da célula. O valor da cor pode usar uma string hexadecimal, como #2ca6cd, ou uma string de cor nomeada CSS, como mediumblue.

bg_color

O subparâmetro bg_color indica a cor de fundo da célula. O valor da cor pode usar uma string hexadecimal, como #2ca6cd, ou uma string de cor nomeada CSS, como mediumblue.

bold

O subparâmetro bold indica se o texto da célula está em negrito e aceita true ou false.

italic

O subparâmetro italic indica se o texto da célula está em itálico e aceita true ou false.

align

O subparâmetro align indica o alinhamento do texto da célula e aceita left, center ou right.

series_collapsed

O parâmetro series_collapsed define se os subtotais de uma série específica serão reduzidos ou expandidos. Identifique a série usando a sintaxe view_name.field_name e true ou false.

series_collapsed:
  users.city: false
  users.state: true

Se a coluna estiver recolhida, clique na seta à esquerda da célula de dados para mostrar os elementos individuais que compõem o subtotal.

series_value_format

O parâmetro series_value_format especifica a formatação a ser aplicada a uma série, independente de qualquer formatação aplicada à dimensão ou métrica subjacente. Se series_value_format não for especificado, o valor será mostrado no formato da dimensão ou métrica subjacente.

Identifique a série a ser formatada usando a sintaxe view_name.field_name.

O subparâmetro format_string permite definir o formato da série usando a formatação do Excel.

series_value_format:
  products.retail_price:
    format_string: "$#,##0.00"

Também é possível definir a formatação assim:


series_value_format:
  order_items.count: "00#"

A formatação usada no subparâmetro format_string é a mesma usada com o parâmetro value_format do LookML. Leia sobre como especificar esses formatos na página de documentação Adicionar formatação personalizada a campos numéricos.

Parâmetros de formatação

Os parâmetros a seguir correspondem às opções no menu Formatação do editor de visualização para gráficos de tabela.

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.

header_font_color

O parâmetro header_font_color aplica uma cor de fonte aos cabeçalhos das colunas.

O valor da cor pode usar uma string hexadecimal, como #2ca6cd, ou uma string de cor nomeada CSS, como mediumblue.


header_font_color: purple

A cor padrão depende do tema da tabela definido usando o parâmetro table_theme.

header_background_color

O parâmetro header_background_color aplica uma cor aos cabeçalhos das colunas em segundo plano.

O valor da cor pode usar uma string hexadecimal, como #2ca6cd, ou uma string de cor nomeada CSS, como mediumblue.


header_background_color: #add8e6

A cor padrão depende do tema da tabela definido usando o parâmetro table_theme.

header_text_alignment

O parâmetro header_text_alignment aplica o alinhamento left, right ou center aos cabeçalhos das colunas.


header_text_alignment: center

O alinhamento padrão é left.

header_font_size

O parâmetro header_font_size aplica um tamanho de fonte de 1 a 99 aos cabeçalhos das colunas.


header_font_size: 16

O tamanho padrão das fontes de cabeçalho e linha é 12.

rows_font_size

O parâmetro rows_font_size aplica um tamanho de fonte de 1 a 99 ao texto dentro das células de dados, mas não aos cabeçalhos das colunas.


rows_font_size: 8

O tamanho padrão das fontes de cabeçalho e linha é 12.

enable_conditional_formatting

Definir enable_conditional_formatting como true permite definir regras que codificam por cores a visualização da tabela, seja em uma escala ou especificando valores de interesse.


enable_conditional_formatting: true | false

conditional_formatting_include_totals

Se enable_conditional_formatting estiver definido como true, conditional_formatting_include_totals vai especificar se os totais estão incluídos no esquema de codificação por cores.


conditional_formatting_include_totals: true | false

conditional_formatting_include_nulls

Se enable_conditional_formatting for definido como true, conditional_formatting_include_nulls vai especificar se os valores nulos devem ser representados como zeros.


conditional_formatting_include_nulls: true | false

conditional_formatting

Com enable_conditional_formatting definido como true, use o parâmetro conditional_formatting para definir as regras que codificam por cores a visualização da tabela. Para cada regra de formatação condicional, é possível especificar configurações com os seguintes parâmetros:

Confira um exemplo de regra de formatação condicional:


conditional_formatting: [{type: less than, value: 20, background_color: "#9fdee0",
  font_color: "#b15928", bold: true, italic: false, strikethrough: false,
  fields: [order_items.count], color_application: {collection_id: my-custom-colors,
  palette_id: my-custom-colors-sequential-0}}]

type

O parâmetro type especifica se os valores devem ser codificados por cores ao longo de uma escala ou com base em uma condição lógica.

Se você estiver codificando valores em uma escala, defina type como along a scale....

Se você estiver codificando valores por cores com base em uma condição lógica, especifique um dos seguintes valores para type, junto com um valor para value:

  • equal to: a regra se aplica a valores iguais ao número especificado para value.
  • not equal to: a regra se aplica a valores que não são iguais ao número especificado para value.
  • greater than: a regra se aplica a valores maiores que o número especificado para value.
  • less than: a regra se aplica a valores menores que o número especificado para value.
  • between: a regra se aplica a valores que estão entre os dois números especificados para value.
  • not between: a regra se aplica a valores que não estão entre os dois números especificados para value.
  • 'null': a regra se aplica apenas a valores nulos.
  • not null: a regra se aplica apenas a valores que não são nulos.

type: along a scale... | equal to | not equal to | less than | between | not between | 'null' | not null

value

Se você estiver codificando valores por cores com base em uma condição lógica diferente de 'null' ou not null, especifique o valor a que a regra se aplica. O parâmetro value usa um único número ou, quando type é definido como between ou not between, um conjunto de dois números.


value: N | [N, N]

background_color

Se a codificação de cores for baseada em uma condição lógica (type está definido como algo diferente de along a scale...), use o parâmetro background_color para especificar uma cor de plano de fundo para os valores a que sua regra se aplica.


background_color: "#49cec1"

font_color

Se a codificação de cores for baseada em uma condição lógica (type está definido como algo diferente de along a scale...), use o parâmetro font_color para especificar uma cor de fonte para os valores a que sua regra se aplica.


font_color: "#1f3e5a"

color_application

O parâmetro color_application e os subparâmetros collection_id, palette_id e options podem ser usados para aplicar uma coleção e uma paleta de cores específicas a uma regra de formatação condicional.

É possível adicionar cores a um painel do LookML por ID de coleção e ID de paleta, se você os tiver. Você também pode usar a UI para encontrar as cores desejadas e gerar o 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 desejadas à 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. Para uma visão geral das coleções de cores predefinidas do Looker, consulte a página de documentação Coleções de cores.

O subparâmetro options pode ser usado quando você define type como along a scale.... Ele tem os seguintes parâmetros filhos:

  • steps: esse parâmetro limita o número de cores usadas ao valor fornecido e separa os dados nesse número de grupos. Quando esse parâmetro não é usado, os dados são coloridos de acordo com um gradiente que abrange toda a paleta. Ele aceita valores de 2 a 100.
  • mirror: quando definido como true, esse parâmetro aplica mudanças de cor iguais em ambos os lados da paleta para valores iguais em ambos os lados de um ponto central definido. Ele aceita true ou false.
  • constraints: esse parâmetro define o intervalo de dados a que a formatação condicional se aplica e define um ponto central a ser usado para a aplicação da paleta. Ele aceita a seguinte sintaxe: constraints: {min: {type: number, value: 3}, max: {type: percentile, value: 99}, mid: {type: average}}
  • reverse: esse parâmetro determina se a paleta de cores será invertida durante a aplicação de cores. Ele aceita true ou false.

bold

Ao usar cores com base em uma condição lógica, defina se os valores a que sua regra se aplica devem ser mostrados em negrito.


bold: true | false

italic

Ao usar cores com base em uma condição lógica, defina se os valores a que sua regra se aplica devem ser mostrados em itálico.


italic: true | false

strikethrough

Ao usar cores com base em uma condição lógica, defina se quer aplicar formatação tachada aos valores da regra.


strikethrough: true | false

fields

Especifique os campos a que sua regra deve ser aplicada. Por padrão, a regra se aplica a todos os campos numéricos.


fields: [ view_name.field_name ]