You are viewing documentation for Looker 25.20. Click this link to see the most recent documentation.

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

En esta página, se describen las opciones para crear un elemento de panel de LookML de type: looker_column con parámetros de panel de LookML en un archivo dashboard.lkml.

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

Ejemplo de uso


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

## QUERY PARAMETERS
model: model_name
explore: explore_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, …]
limit: N
column_limit: N
filters:
  view_name.field_name: 'Looker filter expression' | 'filter value'
listen:
  dashboard_filter_name: dimension_or_measure_name
query_timezone: 'specific timezone' | user_timezone
merged_queries:
- 'primary query definition'
- 'next source query definition'
  join_fields:
  - field_name: view_name.field_name
    source_field_name: view_name.field_name

## PLOT PARAMETERS
stacking: normal | percent | ''
show_dropoff: true | false
ordering: none | asc | desc
column_spacing_ratio: number between 0 and 1
column_group_spacing_ratio: number between 0 and 1
hide_legend: true | false
legend_position: center | left | right
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
colors: [css_color, css_color, …]
series_colors:
  series_name: css_color
  # Possibly more series color assignments

series_labels:
  'Series Name': desired series label
  # Possibly more series label assignments
series_types:
   series_name: column | line | area | scatter
   # Possibly more series visualization assignments
show_view_names: true | false

## VALUE PARAMETERS
show_value_labels: true | false
show_null_labels: true | false
label_color: [css_color, css_color, …]
font_size: Npx
label_rotation: N
label_value_format: 'value formatting string'
show_totals_labels: true | false
hidden_series: [series_name, series_name, …]
show_silhouette: true | false
totals_color: css_color

## X-AXIS PARAMETERS
x_axis_scale: auto | ordinal | time
x_axis_reversed: true | false
show_x_axis_label: true | false
x_axis_label: desired x-axis label
show_x_axis_ticks: true | false
x_axis_gridlines: true | false
x_axis_label_rotation: N
x_axis_datetime_label: 'time formatting string'
x_axis_zoom: true | false

## Y-AXIS PARAMETERS
y_axis_gridlines: true | false
y_axis_reversed: true | false
reference_lines:
  # reference line options
y_axis_zoom: true | false

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

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 aparece el nombre de un elemento para 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 de `layout: tile` y `layout: static`
`width` (para elementos)	Define el ancho de un elemento en unidades de `tile_size` para los paneles de `layout: tile` y `layout: static`.
`top`	Define la posición de arriba hacia abajo de un elemento en unidades de `tile_size` para los paneles de `layout: static`.
`left`	Define la posición de izquierda a derecha de un elemento en unidades de `tile_size` para los 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`	Comienza una sección de LookML para definir una nota para un elemento. Este parámetro tiene los subparámetros `text`, `state` y `display`.
Parámetros de búsqueda
`model`	Define el modelo que se usará para la búsqueda del elemento.
`explore` (para elementos)	Define el Explore que se usará para la consulta del elemento.
`dimensions`	Define las dimensiones que se usarán para la consulta del elemento.
`measures`	Define las medidas 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 segmentar para usarse en la consulta del elemento.
`limit`	Define el límite de filas que se usará para la consulta del elemento.
`filters` (para elementos)	Define los filtros que no se pueden 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 búsqueda.
`merged_queries`	Define una búsqueda de resultados combinados.
Parámetros de trazado
`stacking`	Apila las series una sobre otra para crear un gráfico apilado.
`show_dropoff`	Agrega flechas que muestran el cambio porcentual entre los puntos de datos.
`ordering`	Establece el orden de los valores de las series en un gráfico de barras apiladas o de porcentaje apilado
`column_spacing_ratio`	Establece el espaciado entre las columnas dentro de un grupo.
`column_group_spacing_ratio`	Establece el espaciado entre los grupos de columnas en un valor entre 0 y 1.
`hide_legend`	Oculta la leyenda del gráfico.
`legend_position`	Especifica si la leyenda aparece a la izquierda, en el centro o a la derecha del gráfico.
`hidden_fields`	Especifica los campos que se usarán en la consulta, pero que se ocultarán en el gráfico.
`limit_displayed_rows`	Muestra u oculta filas en una visualización según su posición en los resultados.
`limit_displayed_rows_values`	Especifica qué filas se mostrarán u ocultarán en una visualización. Este parámetro tiene los subparámetros `show_hide`, `first_last` y `num_rows`.
Parámetros de la serie
`colors`	Establece los colores de las series del gráfico según el orden en que aparecen.
`series_colors`	Establece los colores de las series de gráficos según el nombre de la serie
`series_labels`	Cambia la forma en que se muestra el nombre de una serie a los usuarios
`series_types`	Mezcla tipos de visualización definiendo el tipo para cada serie
`show_view_names`	Oculta los nombres de las vistas en las etiquetas del gráfico
Parámetros de valor
`show_value_labels`	Muestra etiquetas junto a los puntos de datos
`show_null_labels`	Determina si se deben mostrar etiquetas nulas en un gráfico cuando se muestran etiquetas.
`label_color`	Especifica una lista de valores de color separados por comas.
`font_size`	Establece el tamaño de fuente de las etiquetas de valores.
`label_rotation`	Con `stacking` establecido en el valor predeterminado (`''`), establece la rotación de las etiquetas de valor en un valor entre `-360` y `360`.
`label_value_format`	Especifica el formato de estilo Excel para las etiquetas de valores.
`show_totals_labels`	Con `stacking` establecido en `normal`, especifica si se muestran los totales de cada grupo apilado de datos en un gráfico.
`hidden_series`	Oculta una serie del gráfico cuando se carga el elemento.
`show_silhouette`	Con `stacking` establecido en `normal`, se muestra una representación ligeramente sombreada de una serie inhabilitada.
`totals_color`	Con `stacking` establecido en `normal`, especifica el color de las etiquetas de totales.
Parámetros del eje X
`x_axis_scale`	Especifica cómo se calcula la escala del eje X
`x_axis_reversed`	Especifica la dirección del eje X.
`show_x_axis_label`	Oculta la etiqueta del eje X.
`x_axis_label`	Define una etiqueta personalizada del eje X
`show_x_axis_ticks`	Muestra marcas en el eje X.
`x_axis_gridlines`	Extiende las líneas de la cuadrícula desde el eje X.
`x_axis_label_rotation`	Rota las etiquetas del eje X una cantidad de grados
`x_axis_datetime_label`	Especifica una cadena de formato para las etiquetas del eje X, si son fechas.
`x_axis_zoom`	Especifica si se permite el zoom a lo largo del eje X.
Parámetros del eje Y
`y_axis_gridlines`	Extiende las líneas de cuadrícula desde el eje Y.
`y_axis_reversed`	Establece la dirección del eje X.
`reference_lines`	Agrega líneas de referencia a un gráfico
`y_axis_zoom`	Especifica si se permite el zoom a lo largo del eje Y. Se inhabilita si `x_axis_zoom: false`.
Parámetros de configuración avanzada de la visualización
`advanced_viz_config`	Acepta un fragmento de código JSON de HighCharts que puede anular varios parámetros de configuración de visualización.

Parámetros básicos

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

`name`

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

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

Cada declaración de name crea un nuevo elemento del 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 de layout: grid.

- name: orders_by_date

`title`

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

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

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

El parámetro title te permite cambiar la forma en que aparecerá el nombre de un elemento para 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 usaste este formato, en lugar de que el elemento aparezca como Resumen de ventas, aparecerá como 1) Resumen de ventas.

`type`

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

type también se puede usar como parte de un filtro del panel, como 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, como 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, como 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 medida, como se describe en la página de documentación Tipos de medidas.

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

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 paneles de LookML.

`height`

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

height también se puede usar como parte de una fila del panel, como 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 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 del panel.

width también se puede usar como parte de un panel, como 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 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 hacia abajo de un elemento, en unidades de tile_size, para los paneles 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 layout: static.

Por ejemplo, el siguiente código especifica tile_size: 100 y left: 4, y 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`

En el caso de los paneles de layout: newspaper, el parámetro row define la fila en la que se coloca el borde superior de un elemento.

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

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 que un elemento se coloque 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`

En el caso de los paneles de layout: newspaper, el parámetro col define la columna en la que se coloca el borde izquierdo del elemento.

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 a la izquierda de un panel (col: 0) tomarían de forma predeterminada las columnas de la 0 a la 7.

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 del panel.

refresh también se puede usar como parte de un panel, como 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 y, de este modo, recupere datos nuevos. 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 número (sin decimales) de segundos, minutos, horas o días. Por ejemplo:

- name: orders_by_date
  refresh: 2 hours

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

`note`

Puedes agregar notas descriptivas a los elementos de la siguiente manera:

- name: element_name
  note:
    text: 'note text'
    state: collapsed | expanded
    display: above | below | hover

note tiene los subparámetros text, state y display.

`text`

El subparámetro text especifica el texto que se muestra en la nota. El texto se puede localizar.

`state`

El parámetro secundario state determina si la nota será collapsed o expanded 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.

`display`

El subparámetro display determina dónde se muestra la nota en un elemento. above coloca la nota en la parte superior de un elemento, below la coloca en la parte inferior y hover requiere que el usuario coloque el cursor sobre el elemento para ver la nota.

Parámetros de consulta

Cuando defines un elemento del 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 o el parámetro measures. También puedes usar los otros parámetros de consulta para controlar la forma en que se muestran los datos en un elemento del panel.

`model`

El parámetro model define el modelo que se usará para la consulta del elemento. 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 resulta especialmente útil si actualizas el nombre de un modelo que usan varios elementos del panel.

Para obtener más información y un ejemplo del uso de constantes con los 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 del panel.

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

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

El parámetro explore define la función Explorar 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 un Explore en un solo lugar, lo que es particularmente útil si actualizas el nombre de un Explore que usan varios elementos del panel.

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

`dimensions`

El parámetro dimensions define la dimensión o las dimensiones que se usarán para la consulta del elemento. Usa la sintaxis view_name.dimension_name para especificar la dimensión. No incluyas dimensions si la búsqueda 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 métrica o las métricas que se usarán para la consulta del elemento. Usa la sintaxis view_name.measure_name para especificar la métrica. No incluyas measures si la búsqueda 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 las ordenaciones que se usarán para la consulta de elementos. El ordenamiento principal aparece primero, luego el secundario y así sucesivamente. Usa la sintaxis view_name.field_name para especificar la dimensión o la métrica. No incluyas sorts si deseas usar el orden de clasificación predeterminado de Looker. Los ordenamientos descendentes tienen el sufijo desc, mientras que los ascendentes no lo necesitan.

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

El parámetro pivots define las dimensiones que se deben segmentar para la consulta de elementos. Usa la sintaxis view_name.dimension_name para especificar la dimensión. No incluyas pivots si la búsqueda 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]

`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

`filters`

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

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

filters también se puede usar como parte de una métrica, como 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 deseas 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.

`listen`

Los filtros del panel permiten que los usuarios refinen de forma interactiva los datos que se muestran en los elementos del panel. Define filtros de panel con el parámetro filters para los 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, podrías 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
    ...

Para obtener ejemplos adicionales sobre el uso del parámetro filters y el parámetro listen para aplicar filtros del panel a elementos individuales del panel, consulta Cómo compilar paneles de LookML.

`query_timezone`

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

- name: orders_by_date
  query_timezone: America/Los Angeles

- name: orders_by_customer
  query_timezone: user_timezone

`merged_queries`

El parámetro merged_queries te permite combinar los resultados de varias búsquedas en un solo elemento del 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 ejemplo de LookML, se crea un elemento de type: looker_grid de resultados combinados. En este ejemplo, el parámetro merged_queries se usa para crear un elemento del panel que combina datos de dos consultas separadas 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 del panel combina datos de dos consultas de origen basadas en la función users Explorar 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 búsqueda de fuente 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 en función de 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 deseas crear una consulta combinada que incluya información sobre empresas de dos exploraciones diferentes: company_info y companies. Deseas unir las consultas en los campos ipo.stock_symbol, companies.name y companies.contact_email de cada Explorar 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 OPI, el símbolo bursátil, la cantidad de empleados y el recuento de empleos. 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

Cómo aplicar filtros a elementos de consultas combinadas

En el ejemplo anterior de un elemento de búsqueda combinado, se muestra cómo aplicar filtros codificados directamente dentro de cada búsqueda 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 filtran previamente los datos antes de combinar las consultas y el usuario no los puede cambiar.

También puedes aplicar filtros del panel a los elementos de consultas combinadas con el parámetro listen dentro de 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 las consultas de origen de la consulta combinada de la siguiente manera:

listen:
  Industry: companies.industry

Por ejemplo, el siguiente código de ejemplo 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 incorporació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 diagrama

La mayoría de los parámetros que se describen en esta sección corresponden a las opciones de la sección Plot del editor de visualización para los gráficos de columnas.

`stacking`

El parámetro stacking especifica cómo se agrupan visualmente las series en un gráfico.

normal: Apila barras, líneas y puntos uno sobre otro, como en un gráfico de columnas apiladas normal.
percent: Apila barras, líneas y puntos para completar el 100% del gráfico y establece los valores del eje Y como porcentajes.
'': Las barras, las líneas y los puntos no se apilan, sino que se agrupan.

stacking: normal | percent | ''

## default value: ''

`show_dropoff`

El parámetro show_dropoff activa o desactiva la aparición de flechas de cambio porcentual en todo el gráfico. Para cada serie, estas flechas muestran el porcentaje del valor anterior de izquierda a derecha.

show_dropoff: true | false

## default value: false

`ordering`

El parámetro ordering te permite ordenar cada porción de un gráfico de barras apiladas o de porcentaje apilado según el tamaño de cada porción.

none (o no se especifica ningún valor): Los valores de la serie se ordenarán según sus posiciones en la tabla de datos.
asc: Los valores de la serie más pequeños se posicionarán en la parte inferior, y los valores aumentarán de tamaño hacia la parte superior de la pila de columnas.
desc: Los valores más grandes se posicionarán en la parte inferior, y los valores disminuirán en tamaño hacia la parte superior.

`column_spacing_ratio`

El parámetro column_spacing_ratio establece el espaciado entre las columnas dentro de un grupo. Esta opción está disponible para los gráficos que tienen stacking configurado como el parámetro de configuración agrupado predeterminado, especificado con '' en LookML. Este parámetro acepta valores entre 0 y 1. 0 se asocia con el espaciado mínimo entre columnas dentro de un grupo, y 1 se asocia con el espaciado máximo entre columnas dentro de un grupo.


column_space_ratio: number between 0 and 1

`column_group_spacing_ratio`

El parámetro column_group_spacing_ratio establece el espaciado entre los grupos de columnas. Este parámetro acepta valores entre 0 y 1. 0 se asocia con el espaciado mínimo entre los grupos de columnas, y 1 se asocia con el espaciado máximo entre los grupos de columnas.


column_group_spacing_ratio: number between 0 and 1

`hide_legend`

Esta declaración ocultará la leyenda de la visualización.

hide_legend: true | false

## default value: false

`legend_position`

Si hide_legend está establecido en false (y hay más de una serie), puedes usar el parámetro legend_position para especificar si la leyenda de la serie aparecerá a la izquierda, en el centro o a la derecha del gráfico.

legend_position: center | left | right

## default value: false

`hidden_fields`

El parámetro hidden_fields indica qué campos, si los hay, se usan en la búsqueda, pero están ocultos en el gráfico. Los campos ocultos aparecerán en la sección de la tabla de datos de un Explorar.

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 desees ocultar las primeras 6 filas. Si configuras este parámetro en true, puedes especificar los valores y las posiciones en la visualización a los 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 parámetro secundario 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 parámetro secundario 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 muestran u ocultan las primeras filas, mientras que si lo estableces en last, se muestran u ocultan las últimas filas.first_last

`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 la serie

Los parámetros que se describen en esta sección corresponden a las opciones de la sección Series del editor de visualizaciones para los gráficos de columnas.

`colors`

El parámetro colors especifica una lista de colores para la serie. El primer color de la lista corresponde a la primera serie de datos. Si hay más series que colores enumerados, los colores volverán a comenzar desde el principio.


colors: [blue, orange, yellow, red, purple]

Para todos los atributos del gráfico que especifican un color, el valor del color puede tomar una cadena hexadecimal, como #2ca6cd, o una cadena de color con nombre CSS, como mediumblue.

`series_colors`

Establece los colores de las series según el nombre de la serie, con pares name: value.

En un gráfico de tabla dinámica, los nombres de las series son los nombres de la tabla dinámica.

series_colors:
  'Yes': skyblue
  'No': '#000000'

En el caso de un gráfico con varias medidas, los nombres de las series son los nombres de los campos de medida.

series_colors:
  inventory_items.count: crimson
  orders.count: green

Si el nombre de la serie no aparece en series_colors, el gráfico usará de forma predeterminada la lista de colores proporcionada en colors. Si no se establece colors, el gráfico volverá al esquema de color predeterminado.

`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 de tabla dinámica, los nombres de las series son los nombres de la tabla dinámica.

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

En el caso de un gráfico con varias medidas, los nombres de las series son los nombres de los campos de medida.

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

`series_types`

El parámetro series_type te permite usar diferentes tipos de gráficos cartesianos en la misma visualización. Usa este parámetro para asignar un tipo de gráfico a cada serie que desees cambiar. Las opciones de tipo son line, column, bar, area y scatter.

series_types:
  series_a_name: column
  series_b_name: line

Todas las series se establecen de forma predeterminada en el tipo de gráfico inicial que elijas. Luego, puedes modificar las series individuales.

`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 los nombres de las columnas.

show_view_names: true | false

## default value: true

Parámetros de valor

Los parámetros que se describen en esta sección corresponden a las opciones de la sección Valores del editor de visualizaciones para los gráficos de columnas.

`show_value_labels`

Mostrar el valor de una barra, una línea o un punto junto al dato

show_value_labels: true | false

## default value: false

`show_null_labels`

Determina si se deben mostrar etiquetas para las columnas o barras nulas cuando show_value_labels se establece en true.

show_null_labels: true | false

## default value: false

`labelColor`

Si labelColorEnabled está establecido en true, usa el parámetro labelColor para especificar un color personalizado para la etiqueta y los porcentajes. Las etiquetas en las que labelPosition está configurado como inline aparecerán en el color elegido, y las etiquetas a cada lado del gráfico aparecerán aproximadamente un 40% más oscuras que el color elegido.


labelColor: "#4FBC89"

`font_size`

Establece el tamaño de fuente de las etiquetas de valores con cualquier tamaño de CSS válido, como 10px o 12px.


font_size: 14px

`label_rotation`

Establece la rotación de las etiquetas de valores. Este parámetro acepta valores entre -360 y 360, que indican la cantidad de grados para rotar las etiquetas. Este parámetro solo está disponible cuando stacking se establece en el valor predeterminado ('').


label_rotation: -45

`label_value_format`

El parámetro label_value_format especifica el formato que se aplicará a un valor, independientemente del formato que se aplique a la dimensión o la métrica subyacente. El campo acepta el formato de Excel. Si no se especifica label_value_format, el valor se mostrará en el formato de la dimensión o métrica subyacente.

Puedes leer sobre cómo especificar estos formatos en la página de documentación sobre Cómo agregar formato personalizado a los campos numéricos. Sin embargo, el formato de color no es compatible con Looker.

El formato que se usa en el parámetro del panel de LookML label_value_format es el mismo que el que se usa con el parámetro de LookML value_format, excepto que el parámetro de LookML value_format requiere que la cadena de formato se incluya entre comillas dobles.


label_value_format: '0.00'

`show_totals_labels`

Establece si se muestran los totales de cada grupo apilado de puntos de datos en un gráfico. Este parámetro solo está disponible cuando stacking se establece en normal.


show_totals_labels: true | false

`hidden_series`

El parámetro hidden_series especifica qué series se inhabilitarán en el gráfico, lo que significa que aparecerán en la leyenda del gráfico, pero en gris. Los usuarios pueden habilitar las series inhabilitadas haciendo clic en ellas en la leyenda del gráfico. Por lo tanto, es posible que hidden_series no haya funcionado según lo previsto con hide_legend: true.

En el caso de un gráfico de tabla dinámica, los nombres de las series son los nombres de la tabla dinámica:

hidden_series: ['Yes', 'No']

En el caso de un gráfico con varias medidas, los nombres de las series son los nombres de los campos de medida:

hidden_series: [inventory_items.count, orders.count]

Si se usa junto con el parámetro show_silhouette, puedes especificar si las series inhabilitadas se muestran como una representación ligeramente sombreada en el gráfico.

`show_silhouette`

Cuando el parámetro show_silhouette se establece en true y stacking se establece en normal, se mostrará una serie inhabilitada como una silueta ligeramente sombreada.


show_silhouette: true | false

`totals_color`

Este parámetro define el color de las etiquetas de totales en un gráfico. El parámetro totals_color solo está disponible cuando stacking se establece en normal.


totals_color: "#2ca6cd"

Parámetros del eje X

Los parámetros que se describen en esta sección corresponden a las opciones de la sección X del editor de visualizaciones para los gráficos de columnas.

`x_axis_scale`

Este parámetro determina cómo se calcula la escala del eje X.

auto: La escala se inferirá a partir de los datos subyacentes. Esta es la configuración predeterminada.
ordinal: Los datos se representarán como entradas discretas y espaciadas de manera uniforme.
time: Los datos se representarán como tiempo, y el eje se etiquetará de forma adecuada. Esto no funcionará si los datos subyacentes no se pueden convertir a fechas.

x_axis_scale: auto | ordinal | time

## default value: auto

`x_axis_reversed`

Este parámetro establece la dirección del eje X. Cuando x_axis_reversed se establece en false, los valores aumentan de izquierda a derecha. Cuando se establece en true, los valores disminuyen de izquierda a derecha.


x_axis_reversed: true | false

`show_x_axis_label`

Este parámetro determina si se muestran etiquetas en el eje X.

show_x_axis_label: true | false

## default value: true

`x_axis_label`

Este parámetro especifica una etiqueta para el eje X. Puedes usar este parámetro cuando show_x_axis_label se establece en true.

x_axis_label: Order Date

`show_x_axis_ticks`

Este parámetro determina si se muestran etiquetas de valores en el eje X.

show_x_axis_ticks: true | false

## default value: true

`x_axis_gridlines`

Este parámetro determina si las líneas de cuadrícula se extienden desde el eje X.

x_axis_gridlines: true | false

## default value: false

`x_axis_label_rotation`

El parámetro x_axis_label_rotation define la rotación de las etiquetas del eje X en grados. Este parámetro acepta valores entre -360 y 360, que indican la cantidad de grados para rotar las etiquetas.

x_axis_label_rotation: -45

`x_axis_datetime_label`

Este parámetro especifica una cadena de formato para las etiquetas del eje X, si son fechas. Si x_axis_scale no está configurado como time, esta acción no tendrá ningún efecto.


x_axis_datetime_label: '%b %d'

Consulta la página de documentación Formato de hora para gráficos para obtener información sobre el formato de horas.

`x_axis_zoom`

Este parámetro especifica si los usuarios pueden acercar el eje X de la visualización. Cuando x_axis_zoom se establece en true, el zoom está disponible. Cuando x_axis_zoom se establece en false, el zoom no está disponible.

Si x_axis_zoom se establece en false, se inhabilita y_axis_zoom.

x_axis_zoom: true | false

# default value: true

Parámetros del eje Y

En construcción: Estamos trabajando para actualizar esta sección de la página. Mientras tanto, puedes consultar la página de documentación de Opciones de gráficos de columnas para ver las opciones equivalentes del menú de visualización para el eje Y.

Los parámetros que se describen en esta sección corresponden a las opciones de la sección Y del editor de visualizaciones para los gráficos de columnas.

`y_axis_gridlines`

Este parámetro determina si las líneas de cuadrícula se extienden desde el eje Y.

y_axis_gridlines: true | false

## default value: true

`y_axis_reversed`

Este parámetro establece la dirección del eje Y. Cuando y_axis_reversed se establece en false, los valores aumentan a medida que suben por el eje. Cuando se establece en true, los valores disminuyen a medida que se avanza hacia abajo en el eje.


## y_axis_reversed: true | false

# default value: false

`reference_lines`

Este parámetro especifica un array de valores para especificar líneas y regiones de referencia.

Consulta la página de documentación Parámetros de las líneas de referencia del panel para obtener información sobre cómo configurar las líneas de referencia.


reference_lines:
   # reference line options

`y_axis_zoom`

Este parámetro especifica si los usuarios pueden acercar el eje Y de la visualización. Cuando y_axis_zoom se establece en true, el zoom está disponible.

Cuando y_axis_zoom se establece en false, los usuarios no pueden acercar porciones más pequeñas del eje Y. Sin embargo, es posible que los usuarios puedan acercar el eje X a porciones más pequeñas si el parámetro x_axis_zoom está establecido en true.

Si x_axis_zoom se establece en false, se inhabilita y_axis_zoom.

y_axis_zoom: true | false

# default value: true

Parámetros de configuración avanzada de la visualización

Los parámetros que se describen en esta sección corresponden a las anulaciones opcionales de la configuración del gráfico, que puedes aplicar a un gráfico haciendo clic en el botón Editar configuración del gráfico en la sección Gráfico del editor de visualizaciones.

`advanced_vis_config`

Este parámetro acepta un fragmento de código JSON de HighCharts que anula varios parámetros de configuración de visualización y abre nuevas capacidades. Consulta la página de documentación Cómo personalizar visualizaciones con el editor de configuración de gráficos para ver ejemplos del uso de HighCharts JSON para lograr casos de uso comunes.


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

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

# default value: null

Parámetros de gráficos de columnas para paneles de LookML Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Ejemplo de uso

Definiciones de los parámetros

Parámetros básicos

name

title

type

height

Para paneles con diseños tile o static

Para paneles con diseño de newspaper

width

top

left

row

col

refresh

note

text

state

display

Parámetros de consulta

model

explore

dimensions

measures

sorts

pivots

limit

filters

listen

query_timezone

merged_queries

Ejemplo: Combinación de datos de la empresa

Cómo aplicar filtros a elementos de consultas combinadas

Parámetros de diagrama

stacking

show_dropoff

ordering

column_spacing_ratio

column_group_spacing_ratio

hide_legend

legend_position

hidden_fields

limit_displayed_rows

limit_displayed_rows_values

show_hide

first_last

num_rows