Parámetros de gráficos de tabla para paneles de LookML

En esta página, se muestra cómo agregar y personalizar un elemento de panel de LookML de type: looker_grid con parámetros de panel de LookML en un archivo dashboard.lkml.

Para obtener información sobre cómo crear un gráfico de tabla a través de la IU de Looker, consulta la página de documentación Opciones de gráficos de tabla.

Ejemplo 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'}

Definiciones de los parámetros

Nombre del parámetro Descripción
Parámetros básicos
name (para elementos) Crea un elemento
title (para elementos) Cambia la forma en que se muestra el nombre de un elemento a los usuarios.
type (para elementos) Determina el tipo de visualización que se usará en el elemento.
height (para elementos) Define la altura de un elemento en unidades de tile_size para los paneles layout: tile y layout: static
width (para elementos) Define el ancho de un elemento en unidades de tile_size para los paneles layout: tile y layout: static
top Define la posición de arriba hacia abajo de un elemento en unidades de tile_size para paneles layout: static
left Define la posición de izquierda a derecha de un elemento en unidades de tile_size para paneles de layout: static
row Define la posición de arriba hacia abajo de un elemento en unidades de filas para los paneles de layout: newspaper
col Define la posición de izquierda a derecha de un elemento en unidades de columnas para los paneles de layout: newspaper
refresh (para elementos) Establece el intervalo en el que se actualizará automáticamente el elemento
note_state Define si la nota se contraerá o expandirá si es demasiado grande para caber en una sola fila dentro del ancho del elemento
note_display Define dónde se muestra la nota en un elemento
note_text Especifica el texto que se muestra en la nota
Parámetros de búsqueda
model Define el modelo que se usará para la consulta del elemento
explore (para elementos) Define la exploración que se usará para la consulta del elemento
fields Define los campos que se usarán para la consulta del elemento. Esto se puede usar en lugar de dimensions y measures.
dimensions Define las dimensiones que se usarán para la consulta del elemento
measures Define las mediciones que se usarán para la consulta del elemento
sorts Define las ordenaciones que se usarán para la consulta del elemento
pivots Define las dimensiones que se deben dinamizar para usarlas en la consulta del elemento
fill_fields Define las dimensiones que utilizan la opción de relleno de dimensiones.
subtotals Define los campos que se subtotalizan
total Especifica si se muestran los totales de las columnas en una visualización de tabla
row_total Especifica si se muestran los totales de las filas en una visualización de tabla
limit Define el límite de filas que se usará para la consulta del elemento
column_limit Define el límite de columnas que se usará para la consulta del elemento.
filters (para elementos) Define los filtros que no se pueden cambiar para la consulta del elemento.
filter_expression Define un filtro personalizado que no se puede cambiar para la consulta del elemento.
listen Define los filtros que se pueden cambiar para la consulta del elemento, si se crearon filters (para el panel)
query_timezone Define la zona horaria que se debe usar cuando se ejecuta la consulta.
analysis_config Se agregó en la versión 21.14 Define el análisis de previsión que se debe realizar cuando se ejecuta la consulta. Requiere que esté habilitada la función de Labs Previsión.
merged_queries Define una consulta de resultados combinados.
Parámetros de columna
auto_size_all_columns Cambia automáticamente el tamaño de cada columna de la tabla al ancho de su encabezado o al valor de datos más largo, lo que sea más ancho
column_order Ordena las columnas en el gráfico de tabla.
pinned_columns Define las columnas que se fijarán o inmovilizarán en el lado izquierdo del gráfico de tabla.
Parámetros de trazado
table_theme Aplica una de las cinco opciones de color de tabla a una visualización de tabla
show_row_numbers Establece si se debe mostrar un número de fila al principio de cada fila de la tabla.
hide_totals Establece si una visualización de tabla muestra los totales de las columnas
hide_row_totals Establece si una visualización de tabla muestra los totales de las filas
transpose Establece si se deben transponer las filas de la tabla en columnas.
hidden_fields Especifica los campos que se usarán en la consulta, pero que se ocultarán del gráfico.
limit_displayed_rows Muestra u oculta filas en una visualización según su posición en los resultados
Parámetros de la serie
truncate_text Acorta los encabezados de las columnas y el texto dentro de las celdas de datos con puntos suspensivos (…)
show_view_names Muestra el nombre de la vista junto con el nombre del campo para cada encabezado de columna
size_to_fit Ajusta automáticamente el ancho de todas las columnas para que la tabla se adapte perfectamente al ancho del elemento en el que se visualiza.
dynamic_fields Incluye cálculos basados en tablas o campos personalizados en tu gráfico de tabla.
series_labels Especifica una etiqueta personalizada para cada columna de la visualización
series_column_widths Especifica anchos específicos para las columnas de la visualización
series_cell_visualizations Especifica si las columnas usan la opción de visualización Visualización de celdas. Este parámetro tiene los subparámetros is_active, palette y value_display.
series_text_format Especifica el diseño del texto de las celdas para cada columna. Este parámetro tiene los subparámetros fg_color, bg_color, bold, italic y align.
series_collapsed Especifica si una columna que tiene subtotales aparecerá contraída.
series_value_format Define el formato de valor de una columna con el formato personalizado.
Parámetros de formato
color_application Aplica colores a las visualizaciones de celdas y al formato condicional
header_font_color Aplica un color de fuente a los encabezados de columna
header_background_color Aplica un color a los fondos de los encabezados de columna.
header_text_alignment Aplica la alineación izquierda, derecha o centrada a los encabezados de columna.
header_font_size Aplica un tamaño de fuente a los encabezados de columna
rows_font_size Aplica un tamaño de fuente al texto dentro de las celdas de datos
enable_conditional_formatting Se establece en true para definir reglas de codificación por color para una visualización de tabla
conditional_formatting_include_totals Especifica si los totales se incluyen en el esquema de codificación por colores
conditional_formatting_include_nulls Especifica si los valores nulos se deben representar como un cero
conditional_formatting Usa conditional_formatting y sus subparámetros para definir las reglas que codifican por color la visualización de la tabla.

Parámetros básicos

Cuando defines un elemento de panel de LookML, debes especificar valores para, al menos, los parámetros name y type. Otros parámetros básicos, como title, height y width, afectan la posición y la apariencia de un elemento en un panel.

name

En esta sección, se hace referencia al parámetro name que forma parte de un elemento de panel.

name también se puede usar como parte de un filtro de panel, que se describe en la página de documentación Parámetros del panel.

Cada declaración name crea un nuevo elemento de panel y le asigna un nombre. Los nombres de los elementos deben ser únicos. A veces, se hace referencia a los nombres en el parámetro elements cuando usas paneles layout: grid o en el parámetro group de los elementos secundarios cuando organizas elementos en un grupo de tarjetas (type: group).

- name: orders_by_date

title

En esta sección, se hace referencia al parámetro title que forma parte de un elemento de panel.

title también se puede usar como parte de un panel, que se describe en la página de documentación Parámetros del panel.

title también se puede usar como parte de un filtro de panel, que se describe en la página de documentación Parámetros del panel.

El parámetro title te permite cambiar la forma en que se mostrará el nombre de un elemento a los usuarios. Si no se especifica, el título se establece de forma predeterminada en el elemento name.

Considera el siguiente ejemplo:

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

Si usaras este formato, en lugar de que el elemento aparezca como Descripción general de las ventas, aparecería como 1) Descripción general de las ventas.

type

En esta sección, se hace referencia al parámetro type que forma parte de un elemento de panel.

type también se puede usar como parte de un filtro de panel, que se describe en la página de documentación Parámetros del panel.

type también se puede usar como parte de una unión, que se describe en la página de documentación del parámetro type (para uniones).

type también se puede usar como parte de una dimensión, que se describe en la página de documentación Tipos de dimensiones, filtros y parámetros.

type también se puede usar como parte de una medición, que se describe en la página de documentación Tipos de mediciones.

El parámetro type determina el tipo de visualización que se usará en el 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 | button | group

Consulta la página de documentación de type (para paneles de LookML) para obtener una descripción general de los diferentes tipos de elementos de panel de LookML.

height

En esta sección, se hace referencia al parámetro height que forma parte de un elemento de panel.

height también se puede usar como parte de una fila del panel, que se describe en la página de documentación Parámetros del panel.

Para paneles con diseños tile o static

El parámetro height define la altura de un elemento, en unidades de tile_size (que se define en píxeles), para los paneles layout: tile y layout: static.

Por ejemplo, el siguiente código especifica tile_size: 100 y height: 4, lo que hace que el elemento orders_by_date tenga 400 píxeles de altura.

- dashboard: sales_overview
  tile_size: 100
  ...

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

Para paneles con diseño de newspaper

El parámetro height define la altura de un elemento, en unidades de fila, para los paneles de layout: newspaper.

Un panel con diseño de periódico tiene una altura de elemento predeterminada de 6 filas, o alrededor de 300 píxeles. La altura mínima es de 1 fila para los paneles con un parámetro preferred viewer establecido en dashboards-next. La altura mínima es de 2 filas para los paneles con un parámetro preferred viewer establecido en dashboards.

Por ejemplo, el siguiente código establece que un elemento tenga 12 filas de alto, o el doble de alto que otros elementos que se establecen en el valor predeterminado:

- dashboard: sales_overview
  layout: newspaper
  ...

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

width

En esta sección, se hace referencia al parámetro width que forma parte de un elemento de panel.

width también se puede usar como parte de un panel, que se describe en la página de documentación Parámetros del panel.

El parámetro width define el ancho de un elemento, en unidades de tile_size, para los paneles layout: tile y layout: static.

Por ejemplo, el siguiente código especifica tile_size: 100 y width: 4, lo que hace que el elemento orders_by_date tenga 400 píxeles de ancho.

- dashboard: sales_overview
  tile_size: 100
  ...

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

El parámetro width define el ancho de un elemento, en unidades de columnas, para los paneles de layout: newspaper.

Un panel con diseño de periódico tiene un ancho predeterminado de 24 columnas.

Por ejemplo, el siguiente código establece el elemento en la mitad del ancho del panel:

- dashboard: sales_overview
  layout: newspaper
  ...

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

top

El parámetro top define la posición de arriba abajo de un elemento, en unidades de tile_size, para los paneles de layout: static.

Por ejemplo, el siguiente código especifica tile_size: 100 y top: 4, lo que posiciona el borde superior del elemento orders_by_date a 400 píxeles de la parte superior del panel.

- dashboard: sales_overview
  tile_size: 100
  ...

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

left

El parámetro left define la posición de izquierda a derecha de un elemento, en unidades de tile_size, para los paneles de layout: static.

Por ejemplo, el siguiente código especifica tile_size: 100 y left: 4, lo que posiciona el borde izquierdo del elemento orders_by_date a 400 píxeles del lado izquierdo del panel.

- dashboard: sales_overview
  tile_size: 100
  ...

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

row

Para los paneles layout: newspaper, el parámetro row define la fila en la que se coloca el borde superior de un elemento. Si el elemento se coloca dentro de un grupo de tarjetas con el parámetro group, row define la posición de la fila del elemento en relación con la parte superior del contenedor del grupo (row: 0).

Un panel comienza con la fila 0 en la parte superior. Un panel con diseño de periódico tiene una altura de elemento predeterminada de 6 filas, lo que significa que los elementos del panel en la parte superior de un panel (row: 0) ocuparían las filas de la 0 a la 5 de forma predeterminada.

Cada fila tiene 50 píxeles de alto, lo que significa que la altura predeterminada del elemento de 6 filas es de 300 píxeles.

Por ejemplo, el siguiente código establece un elemento que se colocará en la segunda fila de elementos del panel, suponiendo que los elementos se establecen en la altura predeterminada:

- dashboard: sales_overview
  layout: newspaper
  ...

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

col

Para los paneles layout: newspaper, el parámetro col define la columna en la que se coloca el borde izquierdo del elemento. Si el elemento se coloca dentro de un grupo de tarjetas con el parámetro group, col define la posición de la columna del elemento en relación con el borde izquierdo del contenedor del grupo (col: 0).

Los paneles se dividen en 24 columnas. Un panel comienza con la columna 0 a la izquierda del panel. Un panel con diseño de periódico tiene un ancho de elemento predeterminado de 8 columnas, lo que significa que los elementos del panel que se encuentran a la izquierda (col: 0) ocuparían las columnas de la 0 a la 7 de forma predeterminada.

Por ejemplo, el siguiente código establece que un elemento se coloque en la tercera columna de elementos del panel:

- dashboard: sales_overview
  layout: newspaper
  ...

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

refresh

En esta sección, se hace referencia al parámetro refresh que forma parte de un elemento de panel.

refresh también se puede usar como parte de un panel, que se describe en la página de documentación Parámetros del panel.

El parámetro refresh permite que un elemento se vuelva a cargar automáticamente de forma periódica, lo que recupera datos actualizados. Esto suele ser útil en entornos en los que se muestra un panel de forma constante, como en la TV de una oficina. Ten en cuenta que el panel debe estar abierto en una ventana del navegador para que este parámetro tenga efecto. Este parámetro de configuración no se ejecuta en segundo plano para "precalentar" la caché del panel.

La frecuencia de actualización puede ser cualquier cantidad (sin decimales) de segundos, minutos, horas o días. Por ejemplo:

- name: orders_by_date
  refresh: 2 hours

Ten cuidado cuando configures intervalos de actualización cortos. Si la consulta detrás del elemento consume muchos recursos, es posible que ciertos elementos sobrecarguen tu base de datos más de lo deseado.

note_state

El parámetro note_state define si una nota se contraerá o expandirá si es demasiado grande para caber en una sola fila dentro del ancho del elemento. Si eliges collapsed y la nota es demasiado larga, terminará con puntos suspensivos en los que se puede hacer clic (...) para leer la nota completa. Si eliges expanded y la nota es larga, se extenderá a líneas adicionales.

note_display

El parámetro note_display define dónde se muestra una nota en un elemento. above coloca la nota en la parte superior de un elemento, below la coloca en la parte inferior de un elemento y hover requiere que el usuario coloque el cursor sobre un ícono de ? para ver la nota.

note_text

El parámetro note_text especifica el texto que se muestra en una nota de elemento.

Parámetros de consulta

Cuando defines un elemento de panel de LookML, debes especificar valores para, al menos, los parámetros de consulta model y explore, y se debe especificar al menos un campo con el parámetro dimensions, el parámetro measures o el parámetro fields. También puedes usar los otros parámetros de consulta que se describen en esta sección para controlar la forma en que se muestran los datos en un elemento de panel.

model

El parámetro model define el modelo que se usará para la consulta de elementos. Si no se especifica, se usará de forma predeterminada el modelo en el que reside el panel.

- name: orders_by_date
  model: ecommerce

El parámetro model acepta constantes de LookML. Puedes definir una constante en el archivo de manifiesto de tu proyecto y, luego, usar la sintaxis "@{constant_name}" para establecer la constante como el valor de model. Usar una constante te permite definir el nombre de un modelo en un solo lugar, lo que es particularmente útil si actualizas el nombre de un modelo que usan varios elementos de panel.

Para obtener más información y un ejemplo de cómo usar constantes con paneles de LookML, consulta la página de documentación del parámetro constant.

explore

En esta sección, se hace referencia al parámetro explore que forma parte de un elemento de panel.

explore también se puede usar como parte de un modelo, que se describe en la página de documentación del parámetro explore.

explore también se puede usar como parte de un filtro de panel, que se describe en la página de documentación Parámetros del panel.

El parámetro explore define la exploración que se usará para la consulta del elemento.

- name: orders_by_date
  explore: order

El parámetro explore acepta constantes de LookML. Puedes definir una constante en el archivo de manifiesto de tu proyecto y, luego, usar la sintaxis "@{constant_name}" para establecer la constante como el valor de explore. Usar una constante te permite definir el nombre de una exploración en un solo lugar, lo que es particularmente útil si actualizas el nombre de una exploración que usan varios elementos de panel.

Para obtener más información y un ejemplo de cómo usar constantes con paneles de LookML, consulta la página de documentación del parámetro constant.

fields

El parámetro fields define los campos que se usarán para la consulta de elementos. Usa la sintaxis view_name.dimension_name para especificar los 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]

Si usas el parámetro fields, no necesitas usar los parámetros dimensions y measures.

dimensions

El parámetro dimensions define la dimensión o las dimensiones que se usarán para la consulta de elementos. Usa la sintaxis view_name.dimension_name para especificar la dimensión. No incluyas dimensions si la consulta no tiene ninguno.

## 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

El parámetro measures define la medición o las mediciones que se usarán para la consulta de elementos. Usa la sintaxis view_name.measure_name para especificar la medición. No incluyas measures si la consulta no tiene ninguno.

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

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

sorts

El parámetro sorts define el comportamiento de ordenamiento para la consulta del elemento. Enumera primero el campo de ordenamiento principal, seguido de los campos de ordenamiento secundarios. Usa la sintaxis view_name.field_name para especificar la dimensión o la medición por la que se ordenará.

Si omites el parámetro sorts, el elemento usa el orden de clasificación predeterminado de Looker. Las ordenaciones ascendentes no requieren un sufijo, mientras que las descendentes requieren el sufijo desc.

En el siguiente ejemplo, se define un solo orden:

- name: orders_by_date
  sorts: order.order_date desc

En el siguiente ejemplo, se definen varias clasificaciones:

- name: orders_by_date
  sorts: [order.order_date desc, customer.name]

Si dinamizas las dimensiones, puedes ordenar los resultados de la consulta especificando el nombre de la medición, la dirección de ordenamiento y el número de índice basado en 0 de la columna de destino en la tabla de datos. Por ejemplo, el siguiente elemento ordena por la primera columna dinámica con el índice 0:

- name: orders_by_category
  sorts: [orders.count desc 0]

Para ordenar por el total de la fila, especifica el índice de la columna de totales. Por ejemplo, el siguiente elemento ordena por el total de la fila con el índice 2, que representa la columna de totales para una consulta con dos columnas dinámicas:

- name: orders_by_cohort
  sorts: [users.count desc 2]

pivots

El parámetro pivots define las dimensiones que se deben dinamizar para la consulta de elementos. Usa la sintaxis view_name.dimension_name para especificar la dimensión. No incluyas pivots si la consulta no tiene ninguno.

## 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

El parámetro fill_fields define las dimensiones que utilizan la opción de relleno de dimensiones. Usa la sintaxis view_name.dimension_name para especificar las dimensiones.

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

subtotals

El parámetro subtotals define las dimensiones que utilizan la opción subtotals. Usa la sintaxis view_name.dimension_name para especificar las dimensiones.

subtotals: [products.department, distribution_centers.name]

total

El parámetro total establece si se muestra una fila de totales en la parte inferior de la tabla. Consulta Muestra totales para obtener más información.

total: true | false

## default value: false

row_total

El parámetro row_total establece si se muestra una columna de totales a la derecha o a la izquierda de la tabla. Solo funciona si hay una tabla dinámica presente. Consulta Muestra totales para obtener más información.

row_total: right | left | false

## default value: false

limit

El parámetro limit define el límite de filas que se debe usar para la consulta de elementos. El límite se aplica a la cantidad de filas antes de que se apliquen las tablas dinámicas.

- name: orders_by_date
  limit: 100

column_limit

El parámetro column_limit define el límite de columnas que se debe usar para la consulta de elementos. El límite se aplica a la cantidad de columnas después de que se aplican las tablas dinámicas.

- name: orders_by_date
  column_limit: 100

filters

En esta sección, se hace referencia al parámetro filters que forma parte de un elemento de panel.

filters también se puede usar como parte de un panel, que se describe en la página de documentación Parámetros del panel.

filters también se puede usar como parte de una medición, que se describe en la página de documentación del parámetro filters.

El parámetro filters define los filtros no modificables que se deben usar para la consulta del elemento. Si quieres filtros que un usuario pueda cambiar en el panel, debes configurarlos con filters para paneles y, luego, aplicarlos a los elementos con listen.

La sintaxis de filters es la siguiente:

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

Cada filtro puede aceptar una expresión de filtro de Looker o una constante de valor. También puedes usar las variables de Liquid _localization o _user_attributes en la expresión de filtro para obtener valores de filtro flexibles.

filter_expression

El parámetro filter_expression define un filtro personalizado que no se puede cambiar para la consulta del elemento. Si quieres filtros que un usuario pueda cambiar en el panel, debes configurarlos con filters para paneles y, luego, aplicarlos a los elementos con listen.

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

En la página de documentación Expresiones de filtro de Looker, se enumeran las expresiones de filtro de Looker.

listen

Los filtros de panel permiten que los usuarios definan mejor de forma interactiva los datos que se muestran en los elementos de panel. Define filtros de paneles con el parámetro filters para paneles de LookML. Luego, usa el parámetro listen para vincular los elementos del panel al filtro del panel.

La sintaxis de listen es la siguiente:

- 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

Agrega el parámetro listen a un elemento y, luego, proporciona el nombre del filtro seguido de dos puntos y una referencia al campo al que se debe aplicar el filtro, con la sintaxis view_name.field_name. Por ejemplo, puedes crear un filtro llamado Fecha que requiera que el usuario ingrese una fecha en el campo de filtro de la IU. Luego, puedes aplicar el valor que ingresa el usuario al elemento orders_by_date de la siguiente manera:

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

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

Si el filtro que se escucha se configura con el parámetro vis_filter: true, el control de filtro aparece en una barra de filtros directamente en la parte superior de esa tarjeta de visualización, en lugar de en la barra de filtros del panel superior.

Para obtener más ejemplos de cómo usar los parámetros filters y listen para aplicar filtros de panel a elementos de panel individuales, consulta Cómo compilar paneles de LookML.

query_timezone

El parámetro query_timezone especifica la zona horaria en la que se ejecutará la consulta. Las opciones de zona horaria se muestran en la página de documentación Valores para timezone. Si quieres que la consulta se ejecute con la zona horaria del visualizador, puedes asignar el valor como user_timezone.

- name: orders_by_date
  query_timezone: America/Los Angeles

- name: orders_by_customer
  query_timezone: user_timezone

analysis_config

Los siguientes subparámetros se pueden usar para definir análisis:

Puedes crear una previsión con una sintaxis como esta:


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

forecasting

forecasting es un tipo de análisis que aplica una previsión a una visualización. La previsión permite que los analistas agreguen rápidamente proyecciones de datos a las consultas de Explorar nuevas o existentes para ayudar a los usuarios a predecir y supervisar datos específicos.

Para obtener más información, consulta la página de documentación Previsiones en visualizaciones.

Para agregar previsiones a las visualizaciones, se debe habilitar la función de Labs de Previsión.

confidence_interval

confidence_interval establece los límites de los valores de datos previstos, que se ingresan como expresiones decimales de porcentajes. confidence_interval es opcional y está en blanco de forma predeterminada.


confidence_interval: 0.99 | 0.98 | 0.95 | 0.90 | 0.80

Consulta la sección Intervalo de predicción en la página de documentación Previsión en visualizaciones.

Para agregar previsiones a las visualizaciones, se debe habilitar la función de Labs de Previsión.

field_name

field_name especifica los nombres de las mediciones (hasta cinco) que se incluirán en las previsiones.


field_name: view_name.field_name

forecast_n

forecast_n especifica la duración de la previsión.


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

Consulta la sección Duración en la página de documentación Previsión en visualizaciones.

Para agregar previsiones a las visualizaciones, se debe habilitar la función de Labs de Previsión.

forecast_interval

forecast_interval establece el intervalo de duración para el que se pronostican los valores de los datos. forecast_interval se completa automáticamente según la dimensión del período en la consulta de Explorar.


forecast_interval: day | month # a timeframe with dimension fill

Consulta la página de documentación de Length.

Para agregar previsiones a las visualizaciones, se debe habilitar la función de Labs de Previsión.

seasonality

seasonality permite que los analistas tengan en cuenta los ciclos conocidos o las tendencias de datos repetitivas en una previsión. seasonality es opcional y está en blanco de forma predeterminada.


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

El parámetro de configuración de estacionalidad Automático se representa como un valor seasonality en blanco.

Consulta la sección Estacionalidad en la página de documentación Previsión en visualizaciones.

Para agregar previsiones a las visualizaciones, se debe habilitar la función de Labs de Previsión.

merged_queries

El parámetro merged_queries te permite combinar los resultados de varias consultas en un solo elemento de panel. Define cada consulta de origen dentro del parámetro merged_queries del elemento y usa el subparámetro join_fields para especificar cómo se deben combinar los resultados.

En el siguiente código de LookML de ejemplo, se crea un elemento de resultados combinados de type: looker_grid. En este ejemplo, se usa el parámetro merged_queries para crear un elemento de panel que combina datos de dos consultas independientes en un solo gráfico de tabla:

- 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

En este ejemplo, el elemento de panel combina datos de dos consultas de origen que se basan en la exploración users del modelo ecommerce. La consulta principal incluye los campos users.state, users.count y users.city, y ordena los resultados por el campo users.count. La segunda consulta de origen incluye los campos users.state y users.city, y ordena los resultados por el campo users.state.

El parámetro join_field combina las consultas de origen según los valores coincidentes en los campos users.state y users.city.

El parámetro listen aplica un filtro State a ambas consultas, lo que permite que los usuarios del panel definan mejor los resultados de la consulta que se muestran en la tarjeta del panel seleccionando un estado específico.

Ejemplo: Combinación de datos de la empresa

Supongamos que quieres crear una consulta combinada que reúna información sobre empresas de dos exploraciones diferentes: company_info y companies. Quieres unir las consultas en los campos ipo.stock_symbol, companies.name y companies.contact_email de cada exploración para crear una consulta que devuelva resultados para el nombre de la empresa, el correo electrónico de contacto de la empresa, el año de la IPO, el símbolo de cotización, la cantidad de empleados y el recuento de puestos de trabajo. Puedes definir el elemento de consulta combinada en LookML de la siguiente manera:

- 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 los elementos de la consulta combinada

En el ejemplo anterior de un elemento de consulta combinada, se muestra cómo aplicar filtros hard-coded directamente en cada consulta de origen con el parámetro filters. Por ejemplo, los filtros companies.contact_email: "-NULL" y ipo.valuation_amount: NOT NULL en la consulta principal restringen los resultados a las empresas que tienen correos electrónicos de contacto y valoraciones válidos. Estos filtros a nivel de la consulta prefiltran los datos antes de combinar las consultas y el usuario no puede cambiarlos.

También puedes aplicar filtros de panel a los elementos de consultas combinadas con el parámetro listen en la definición de cada consulta de origen. Por ejemplo, supongamos que tienes un filtro de panel llamado Industry que definiste a nivel del panel con el parámetro filters para los paneles de 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 el filtro Industry al campo companies.industry en ambas consultas de origen, agrega el parámetro listen a cada una de las definiciones de consulta de origen de la consulta combinada de la siguiente manera:

listen:
  Industry: companies.industry

Por ejemplo, el siguiente código de muestra agrega el filtro Industry a ambas consultas de origen en el elemento de resultados combinados del ejemplo 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

Con esta adición, cuando un usuario interactúe con el filtro del panel Industry, la consulta de origen correspondiente en el elemento de consulta combinada se filtrará según corresponda.

Parámetros de columna

Los siguientes parámetros corresponden a la capacidad de mover y fijar columnas en los gráficos de tablas.

auto_size_all_columns

El parámetro auto_size_all_columns cambia automáticamente el tamaño de cada columna de la tabla al ancho de su encabezado o al valor de datos más largo, lo que sea más ancho. Este parámetro anula los parámetros series_column_widths y size_to_fit, si están definidos.

- name: orders_by_date
  auto_size_all_columns: true

column_order

El parámetro column_order define el orden de las columnas en el gráfico de tabla.

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

pinned_columns

El parámetro pinned_columns define las columnas que se fijan a la izquierda del gráfico de tabla.

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

Parámetros de trazado

Los siguientes parámetros corresponden a las opciones del menú Trazado del editor de visualizaciones para los gráficos de tablas.

table_theme

Usa el parámetro table_theme para aplicar una de las siguientes opciones de color de tabla a un elemento de tabla:

  • editable: La tabla tiene dimensiones azules, mediciones naranjas y cálculos basados en tablas verdes.
  • white: El encabezado de la tabla es blanco, las filas de datos se alternan entre blanco y gris, y el texto es negro.
  • gray: El encabezado de la tabla es gris, las filas de datos alternan entre blanco y gris claro, y el texto es gris oscuro.
  • transparent: El encabezado de la tabla es totalmente transparente, las filas de datos alternan entre gris translúcido y totalmente transparente, y el color del texto se ajusta de negro a blanco según sea necesario de acuerdo con el color de fondo que se muestra. Establecer table_theme en transparent puede ser útil cuando usas un panel incorporado personalizado para que el color de fondo de la tarjeta se muestre a través de la visualización.
  • unstyled: El encabezado de la tabla y las filas de datos son blancos, y el texto es negro.

table_theme: editable | white | gray | transparent | unstyled

show_row_numbers

El parámetro show_row_numbers establece si se mostrará un número de fila al principio de cada fila de la tabla.


show_row_numbers: true | false

hide_totals

Si tu exploración incluye totales de columnas, hide_totals establece si la visualización muestra los totales.


hide_totals: true | false

hide_row_totals

Si tu exploración incluye totales de filas, hide_row_totals establece si los totales de filas se mostrarán en la visualización.


hide_row_totals: true | false

transpose

El parámetro transpose te permite transponer las filas de la tabla en columnas. Acepta true o false.

- name: orders_by_date
  transpose: true

hidden_fields

El parámetro hidden_fields indica qué campos, si los hay, se usan en la consulta, pero se ocultan en el gráfico. Los campos ocultos aparecerán en la sección de la tabla de datos de una exploración.

hidden_fields: [inventory_items.count, distribution_centers.id]

limit_displayed_rows

El parámetro limit_displayed_rows te permite mostrar u ocultar filas en una visualización, según su posición en los resultados. Por ejemplo, si tu visualización muestra un promedio móvil de 7 días, es posible que quieras ocultar las primeras 6 filas. Si estableces este parámetro en true, podrás especificar los valores y las posiciones en la visualización a la que se aplica con el parámetro limit_displays_rows_values y sus subparámetros.

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

limit_displayed_rows_values

Usa el parámetro limit_displayed_rows_values y sus subparámetros show_hide, first_last y num_rows con limit_displayed_rows para especificar qué filas mostrar u ocultar en una visualización. Consulta la sección limit_displayed_rows para ver un ejemplo de uso.

show_hide

El subparámetro show_hide establece si se deben ocultar ciertas filas de la visualización. Establece show_hide en show para mostrar solo una cantidad limitada de filas en la visualización y establece show_hide en hide para excluir ciertas filas de la visualización.

first_last

El subparámetro first_last establece si las filas que se ocultarán o mostrarán serán las primeras o las últimas del conjunto de resultados. Si estableces first_last en first, se mostrarán o se ocultarán las primeras filas, mientras que, si estableces first_last en last, se mostrarán o se ocultarán las últimas filas.

num_rows

El subparámetro num_rows establece la cantidad de filas que se ocultarán o mostrarán. Por ejemplo, num_rows: '10' mostrará u ocultará las primeras o las últimas 10 filas del conjunto de resultados de la visualización.

Parámetros de series

Los siguientes parámetros corresponden a las opciones del menú Series del editor de visualizaciones para los gráficos de tabla.

truncate_text

El parámetro truncate_text establece si los encabezados de columna y el texto dentro de las celdas de datos se deben acortar con puntos suspensivos (…).


truncate_text: true | false

show_view_names

El parámetro show_view_names determina si los nombres de las vistas se muestran en las etiquetas de los gráficos, como los nombres de los ejes y de las columnas.

show_view_names: true | false

## default value: true

size_to_fit

El parámetro size_to_fit establece si se deben ajustar los anchos de todas las columnas para que la tabla se adapte perfectamente al ancho del elemento en el que se visualiza. Si el parámetro auto_size_all_columns se establece en true, anula size_to_fit.


size_to_fit: true | false

dynamic_fields

El parámetro dynamic_fields y sus subparámetros describen los cálculos basados en tablas o los campos personalizados que se usarán con la visualización. Debes tener permiso para crear campos personalizados para agregar un description de hasta 255 caracteres o para usar calculation_type para grupos personalizados o intervalos personalizados. Debes tener permiso para crear cálculos basados en tablas para agregar un description de hasta 255 caracteres a los cálculos basados en tablas o para usar calculation_type para cálculos de acceso directo.

Los siguientes subparámetros se pueden usar para definir campos dinámicos:

Puedes crear un cálculo basado en tablas con una sintaxis 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

Puedes crear cálculos de acceso directo para varios tipos de cálculo con una sintaxis 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

Puedes crear una medida personalizada para usarla en tu visualización con una sintaxis 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

Puedes crear una medida personalizada filtrada para usarla en tu visualización con una sintaxis 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"

Puedes crear una dimensión personalizada para usarla en tu visualización con una sintaxis 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

Puedes crear grupos personalizados para una dimensión que se usará en tu visualización con una sintaxis 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

Puedes crear intervalos personalizados para una dimensión que se usará en tu visualización con una sintaxis 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

Puedes agregar varios campos dinámicos a tu elemento. No es necesario que agregues cálculos basados en tablas al parámetro fields para que aparezcan en la visualización, pero sí debes agregar otros tipos de campos dinámicos a fields para que aparezcan.

table_calculation

Si defines un cálculo basado en tablas, el subparámetro table_calculation asigna un nombre al cálculo basado en tablas. Este es el nombre que se usará cuando hagas referencia al cálculo basado en tablas en LookML.

measure

El subparámetro measure define el nombre de una medida personalizada o una medida personalizada filtrada. Este es el nombre que usas para hacer referencia a la medición en LookML.

dimension

El subparámetro dimension define el nombre de una dimensión personalizada. Este es el nombre que se usará para hacer referencia a la dimensión en LookML.

label

El subparámetro label define el título del campo dinámico tal como quieres que aparezca en la visualización. Este puede ser igual o diferente al nombre que se proporciona en los subparámetros table_calculation, measure o dimension.

based_on

Si usas una medida personalizada o una medida personalizada filtrada, el subparámetro based_on identifica la medida en la que se basa, con la sintaxis view_name.field_name.

type

Si usas una medida personalizada, el subparámetro type identifica el tipo de agregación. Acepta count_distinct, sum, average, min, max o median.

description

Puedes agregar una descripción de hasta 255 caracteres a cualquier campo personalizado o cálculo basado en tablas con el subparámetro description. Looker muestra la descripción cuando el usuario hace clic en el ícono de información que se encuentra a la derecha del nombre del campo en el selector de campos y cuando el usuario coloca el cursor sobre el nombre de la columna en una visualización de tabla o gráfico de tabla en una exploración, un panel o un Look.

expression

Si usas un cálculo basado en tablas, el subparámetro expression define la expresión de Looker que se usa para crear el cálculo basado en tablas.

filter_expression

Si usas una medición filtrada personalizada, el subparámetro filter_expression define la expresión de Looker que se usa para filtrar la medición.

value_format

El subparámetro opcional value_format define el formato del valor de un campo dinámico cuando usas el formato personalizado. Si quieres usar un formato predeterminado de Looker, usa value_format_name en su lugar.

value_format_name

El subparámetro opcional value_format_name aplica un formato predeterminado al campo dinámico. Si quieres usar un formato personalizado, usa value_format en su lugar.

calculation_type

El subparámetro calculation_type define el tipo de función Cálculo de acceso directo o Grupo para crear un cálculo basado en tablas o un grupo personalizado para una dimensión:

Opciones de campos personalizados de calculation_type:

  • group_by: Agrupa los valores de las dimensiones en etiquetas fijas personalizadas, según una condición personalizada especificada. Es similar a CASE WHEN en SQL o al parámetro de campo case de LookML.
  • bin: Agrupa valores en discretizaciones o niveles personalizados para dimensiones de tipo numérico y dimensiones personalizadas. Es similar al tipo de dimensión tier de LookML.

Opciones de cálculos basados en tablas calculation_type:

  • percent_of_column_sum: Es el valor de la fila dividido por la suma de los valores de la columna. Este cálculo solo incluye los valores que se encuentran en la tabla de datos cuando se alcanza el límite de filas de la consulta.
  • percent_of_previous: Es el valor de la fila actual dividido por el valor de la fila siguiente.
  • percent_difference_from_previous: Es la diferencia entre el valor de la fila actual y el valor de la fila siguiente, dividido por el valor de la fila siguiente.
  • rank_of_column: Es la clasificación del valor de una fila entre todos los valores de la columna. Este cálculo solo incluye los valores que se encuentran en la tabla de datos cuando se alcanza el límite de filas de la consulta.
  • running_total: Es la suma acumulativa del valor de la fila actual y todos los valores de las filas anteriores de la columna.
  • percent_of_previous_column: Para los campos dinámicos, el valor de la columna actual dividido por el valor de la columna a su izquierda.
  • percent_change_from_previous_column: Para los campos dinámicos, la diferencia entre el valor de la columna actual y el valor de la columna a la izquierda, dividido por el valor de la columna a la izquierda.
  • percent_of_row: Para los campos dinámicos, el porcentaje del valor de la columna actual dividido por la suma de las filas de ese campo.
  • running_row_total: Para los campos dinámicos, la suma acumulativa de la columna actual y todas las columnas anteriores de esta fila.

args para grupos personalizados

Si usas grupos personalizados para una dimensión, args especifica los argumentos para aplicar etiquetas fijas a los valores de la dimensión. args tiene el siguiente 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.

Puedes agregar tantas condiciones label y filter como sea necesario, según la cantidad de grupos que desees.

Consulta el ejemplo anterior como referencia.

args para discretizaciones personalizadas

Si usas bins personalizados para una dimensión numérica, args especifica los argumentos para aplicar niveles fijos a los valores de la dimensión. args tiene el siguiente 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.

Consulta el ejemplo anterior como referencia.

args para cálculos de accesos directos

En el subparámetro args, se especifican los nombres de los campos numéricos que se usan para un cálculo de acceso directo. Un argumento tiene el siguiente formato:

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

Consulta el ejemplo anterior como referencia.

_kind_hint

El subparámetro opcional _kind_hint identifica si el campo dinámico devuelve una dimensión o una medición. Acepta los valores dimension y measure.

_type_hint

El subparámetro opcional _type_hint identifica el tipo de datos que debe producir la expresión del campo dinámico.

is_disabled

El subparámetro opcional is_disabled especifica si un cálculo basado en tablas aparece en la visualización y en su exploración subyacente. Acepta los valores true y false.

series_labels

Establece las etiquetas de una o más series según el nombre de la serie, con pares name: label.

En un gráfico dinámico, los nombres de las series son los nombres de las tablas dinámicas.

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

En un gráfico con varias mediciones, los nombres de las series son los nombres de los campos de medición.

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

series_column_widths

Establece los anchos de una o más columnas según el nombre de la serie. Si el parámetro auto_size_all_columns se establece en true, anula series_column_widths.

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

series_cell_visualizations

Especifica si una o más columnas usan la opción Visualización de celdas indicando el nombre de la serie con el formato view_name.field_name. series_cell_visualizations tiene los subparámetros is_active, palette y 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

El subparámetro opcional is_active acepta true o false para indicar si las visualizaciones de barras están habilitadas para esa serie. Si no se define is_active, el valor predeterminado es true.

palette

El subparámetro palette es opcional. Si no se usa, la paleta se establecerá de forma predeterminada en una paleta divergente en la colección de colores predeterminada de la instancia.

Si se usa palette, los parámetros secundarios palette_id y collection_id aplican los colores de una paleta específica a las visualizaciones de barras. Para palette_id, debes usar el ID de una paleta secuencial o divergente. Para obtener más información sobre los IDs de paleta y de colección de colores, consulta la sección color_application.

palette tiene un parámetro secundario alternativo, custom_colors, que establece de dos a cinco colores personalizados para usar en las barras:

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

value_display

El subparámetro opcional value_display acepta true o false para indicar si los valores de cada celda de datos se muestran junto con la visualización de la celda. Si no se define value_display, el valor predeterminado es true.

series_text_format

El parámetro series_text_format y sus subparámetros especifican el diseño del texto de la celda para cada columna. La serie a la que se le aplicará el formato se indica con la sintaxis view_name.field_name, y los subparámetros describen el formato.

Todos los subparámetros son opcionales; usa solo los que necesites.

  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

El subparámetro fg_color indica el color de la fuente del texto de la celda. El valor de color puede tomar una cadena hexadecimal, como #2ca6cd, o una cadena de color con nombre de CSS, como mediumblue.

bg_color

El subparámetro bg_color indica el color de fondo de la celda. El valor de color puede tomar una cadena hexadecimal, como #2ca6cd, o una cadena de color con nombre de CSS, como mediumblue.

bold

El subparámetro bold indica si el texto de la celda está en negrita y acepta true o false.

italic

El subparámetro italic indica si el texto de la celda está en cursiva y acepta true o false.

align

El subparámetro align indica la alineación del texto de la celda y acepta left, center o right.

series_collapsed

El parámetro series_collapsed define si se deben contraer o expandir los subtotales de una serie en particular. Identifica la serie con la sintaxis view_name.field_name y true o false.

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

Si la columna está contraída, los elementos individuales que componen el subtotal se mostrarán cuando hagas clic en la flecha que se encuentra en el lado izquierdo de la celda de datos.

series_value_format

El parámetro series_value_format especifica el formato que se aplicará a una serie, independientemente de cualquier formato aplicado a la dimensión o medición subyacente. Si no se especifica series_value_format, el valor se muestra en el formato de la dimensión o medición subyacente.

Identifica la serie a la que se le aplicará el formato con la sintaxis view_name.field_name.

El subparámetro format_string te permite definir el formato de la serie con el formato de estilo de Excel.

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

También puedes definir el formato de la siguiente manera:


series_value_format:
  order_items.count: "00#"

El formato que se usa en el subparámetro format_string es el mismo que se usa con el parámetro de LookML value_format. Puedes leer sobre cómo especificar estos formatos en la página de documentación Agrega formato personalizado a los campos numéricos.

Parámetros de formato

Los siguientes parámetros corresponden a las opciones del menú Formato del editor de visualizaciones para los gráficos de tablas.

color_application

El parámetro color_application y sus subparámetros collection_id y palette_id se pueden usar para aplicar una colección y una paleta de colores específicas a un elemento de panel. Para obtener una descripción general de las colecciones de colores nativas de Looker, consulta la página de documentación Colecciones de colores.

Si tienes el ID de la colección y el ID de la paleta que quieres usar, puedes ingresarlos en los subparámetros collection_id y palette_id. Un ID de colección o de paleta puede ser un código alfanumérico o basarse en el nombre de la colección de colores. Los códigos alfanuméricos se usan para las colecciones nativas de Looker. Son específicas de la instancia y se ven de la siguiente manera:


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

Las colecciones de colores personalizadas usan IDs de colecciones y paletas según el nombre de la colección de colores, que son portátiles entre instancias y se ven de la siguiente manera:


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

También puedes usar la IU para encontrar los colores, las colecciones o las paletas que quieras y generar el LookML para agregarlos a tu panel. Navega a un fragmento de contenido definido por el usuario (como una vista, un panel o una exploración) y aplica los colores, la colección o la paleta que quieras a la visualización de ese contenido con la IU. Una vez que lo hayas hecho, puedes seguir los pasos para obtener el LookML del panel, copiar el LookML que se produjo y pegarlo en la sección color_application.

header_font_color

El parámetro header_font_color aplica un color de fuente a los encabezados de columna.

El valor de color puede tomar una cadena hexadecimal, como #2ca6cd, o una cadena de color con nombre de CSS, como mediumblue.


header_font_color: purple

El color predeterminado depende del tema de la tabla definido con el parámetro table_theme.

header_background_color

El parámetro header_background_color aplica un color a los encabezados de las columnas de fondo.

El valor de color puede tomar una cadena hexadecimal, como #2ca6cd, o una cadena de color con nombre de CSS, como mediumblue.


header_background_color: #add8e6

El color predeterminado depende del tema de la tabla definido con el parámetro table_theme.

header_text_alignment

El parámetro header_text_alignment aplica la alineación left, right o center a los encabezados de las columnas.


header_text_alignment: center

La alineación predeterminada es left.

header_font_size

El parámetro header_font_size aplica un tamaño de fuente de 1 a 99 a los encabezados de columna.


header_font_size: 16

El tamaño predeterminado de las fuentes de encabezado y fila es 12.

rows_font_size

El parámetro rows_font_size aplica un tamaño de fuente de 1 a 99 al texto dentro de las celdas de datos, pero no a los encabezados de columna.


rows_font_size: 8

El tamaño predeterminado de las fuentes de encabezado y fila es 12.

enable_conditional_formatting

Si configuras enable_conditional_formatting como true, puedes definir reglas que codifiquen por color la visualización de la tabla, ya sea en una escala o especificando valores de interés.


enable_conditional_formatting: true | false

conditional_formatting_include_totals

Si enable_conditional_formatting se establece en true, conditional_formatting_include_totals especifica si los totales se incluyen en el esquema de codificación por colores.


conditional_formatting_include_totals: true | false

conditional_formatting_include_nulls

Si enable_conditional_formatting se establece en true, conditional_formatting_include_nulls especifica si los valores nulos se deben representar como ceros.


conditional_formatting_include_nulls: true | false

conditional_formatting

Con enable_conditional_formatting establecido en true, usa el parámetro conditional_formatting para definir las reglas que codifican por color la visualización de la tabla. Para cada regla de formato condicional, puedes especificar la configuración con los siguientes parámetros:

A continuación, se muestra un ejemplo de una regla de formato 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

El parámetro type especifica si se deben colorear los valores de código según una escala o una condición lógica.

Si asignas colores a los valores de una escala, puedes establecer type en along a scale....

Si codificas los valores por color según una condición lógica, puedes especificar uno de los siguientes valores para type, junto con un valor para value:

  • equal to: La regla se aplica a los valores iguales al número especificado para value.
  • not equal to: La regla se aplica a los valores que no son iguales al número especificado para value.
  • greater than: La regla se aplica a los valores que son mayores que el número especificado para value.
  • less than: La regla se aplica a los valores que son inferiores al número especificado para value.
  • between: La regla se aplica a los valores que se encuentran entre los dos números especificados para value.
  • not between: La regla se aplica a los valores que no se encuentran entre los dos números especificados para value.
  • 'null': La regla se aplica solo a los valores nulos.
  • not null: La regla se aplica solo a los valores que no son nulos.

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

value

Si codificas los valores por color según una condición lógica que no sea 'null' o not null, especifica el valor al que se aplica la regla. El parámetro value toma un solo número o, cuando type se establece en between o not between, un conjunto de dos números.


value: N | [N, N]

background_color

Si tu código de colores se basa en una condición lógica (type se establece en cualquier valor que no sea along a scale...), usa el parámetro background_color para especificar un color de fondo para los valores a los que se aplica tu regla.


background_color: "#49cec1"

font_color

Si tu código de colores se basa en una condición lógica (type se establece en cualquier valor que no sea along a scale...), usa el parámetro font_color para especificar un color de fuente para los valores a los que se aplica tu regla.


font_color: "#1f3e5a"

color_application

El parámetro color_application y sus subparámetros collection_id, palette_id y options se pueden usar para aplicar una colección y una paleta de colores específicas a una regla de formato condicional.

Puedes agregar colores a un panel de LookML por ID de colección y de paleta, si los tienes. También puedes usar la IU para encontrar los colores que quieras y generar el código de LookML para agregarlos a tu panel. Navega a un fragmento de contenido definido por el usuario (como una vista, un panel o una exploración) y aplica los colores que quieras a la visualización de ese contenido con la IU. Una vez que lo hayas hecho, puedes seguir los pasos para obtener el LookML del panel, copiar el LookML que se produjo y pegarlo en la sección color_application. Para obtener una descripción general de las colecciones de colores predefinidas de Looker, consulta la página de documentación Colecciones de colores.

El subparámetro options se puede usar cuando configuraste type como along a scale.... Tiene los siguientes parámetros secundarios:

  • steps: Este parámetro limita la cantidad de colores que se usan al valor proporcionado y separa los datos en esa cantidad de grupos. Cuando no se usa este parámetro, los datos se colorean según un gradiente que cubre toda la paleta. Acepta valores de 2 a 100.
  • mirror: Cuando se establece en true, este parámetro aplica cambios de color iguales en ambos lados de la paleta de colores para valores iguales en ambos lados de un punto central definido. Acepta true o false.
  • constraints: Este parámetro establece el rango de datos al que se aplica el formato condicional y establece un punto central que se usará para la aplicación de la paleta. Acepta la siguiente sintaxis: constraints: {min: {type: number, value: 3}, max: {type: percentile, value: 99}, mid: {type: average}}
  • reverse: Este parámetro determina si se debe invertir la paleta de colores durante la aplicación de colores. Acepta true o false.

bold

Cuando uses la codificación por color según una condición lógica, establece si quieres que se muestren en negrita los valores a los que se aplica la regla.


bold: true | false

italic

Cuando uses la codificación por color según una condición lógica, establece si se deben poner en cursiva los valores a los que se aplica la regla.


italic: true | false

strikethrough

Cuando apliques un código de colores según una condición lógica, establece si deseas aplicar el formato de tachado a los valores de tu regla.


strikethrough: true | false

fields

Especifica los campos a los que se debe aplicar tu regla. De forma predeterminada, la regla se aplica a todos los campos numéricos.


fields: [ view_name.field_name ]