Parámetros de diagramas de dispersión para paneles de LookML

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

Para obtener información sobre cómo crear un diagrama de dispersión a través de la IU de Looker, consulta la página de documentación Opciones de diagramas de dispersión.

Ejemplo de uso


## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_scatter
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_null_points: true | false
swap_axes: true | false
cluster_points: true | false
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'
quadrants_enabled: true | false
  quadrant_properties:
    '0':
      color: ''
      label: 'Quadrant 1 label'
    '1':
      color: ''
      label: 'Quadrant 2 label'
    '2':
      color: ''
      label: 'Quadrant 3 label'
    '3':
      color: ''
      label: 'Quadrant 4 label'
custom_quadrant_point_x: 3
custom_quadrant_point_y: 6
custom_quadrant_value_x: 55
custom_quadrant_value_y: 40

## SERIES PARAMETERS
colors: [css_color, css_color, …]
show_view_names: true | false
point_style: none | circle | circle_outline
size_by_field: view_name.field_name
plot_size_by_field: true | false
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
series_point_styles:
  series_name: square | diamond | triangle | triangle-down | auto

## VALUE PARAMETERS
show_value_labels: true | false
custom_value_label_column: default | series_name
label_color: [css_color, css_color, …]
font_size: Npx
label_value_format: 'value formatting string'
hidden_series: [series_name, series_name, …]

## X-AXIS PARAMETERS
x_axis_scale: auto | linear | 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 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 Inicia 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 consulta del elemento
explore (para elementos) Define la exploración que se usará para la consulta del elemento
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
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 consulta.
merged_queries Define una consulta de resultados combinados.
Parámetros de trazado
stacking Apila las series una encima de la otra para crear un gráfico de columnas apiladas
show_null_points Especifica si se deben trazar puntos que tengan valores nulos.
swap_axes Invierte los ejes X e Y en un gráfico.
cluster_points Agrupa grandes cantidades de valores de datos en clústeres
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 deben mostrar o se deben ocultar en una visualización. Este parámetro tiene los subparámetros show_hide, first_last y num_rows.
quadrants_enabled Agrega líneas de cuadrante a un elemento de panel de type: looker_scatter
custom_quadrant_point_x Define la ubicación de la línea vertical del cuadrante
custom_quadrant_point_y Define la ubicación de la línea horizontal del cuadrante
custom_quadrant_value_x Define la ubicación de la línea vertical del cuadrante en función de un valor en el eje X
custom_quadrant_value_y Define la ubicación de la línea horizontal del cuadrante según un valor en el eje Y.
Parámetros de la serie
colors Establece los colores de las series del gráfico según el orden en el que aparecen.
show_view_names Oculta los nombres de las vistas de la etiqueta del gráfico.
point_style Especifica cómo aparecen los datos
size_by_field Asigna un tamaño a todos los puntos del gráfico según un campo específico
plot_size_by_field Establece si el campo que se usa para dimensionar los puntos se traza por separado
series_colors Establece los colores de las series del gráfico 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
series_point_styles Especifica la forma de los puntos del gráfico
Parámetros de valor
show_value_labels Muestra etiquetas junto a los datos.
custom_value_label_column Establece el campo que se usará como las etiquetas de valor para los datos cuando show_value_labels se establezca como verdadero
label_color Especifica una lista de valores de color separados por comas.
font_size Establece el tamaño de fuente de las etiquetas de valor
label_value_format Especifica el formato al estilo de Excel para la etiqueta de valor
hidden_series Oculta una serie de gráficos cuando se carga el elemento.
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 para el eje X
show_x_axis_ticks Muestra marcas en el eje X.
x_axis_gridlines Extiende las líneas de cuadrícula desde el eje X.
x_axis_label_rotation Rota las etiquetas del eje X una cantidad de grados
x_axis_datetime_label Define 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 de visualización avanzada
advanced_viz_config Acepta un fragmento de JSON de HighCharts que puede anular varios parámetros de configuración de visualización.

Parámetros básicos

Cuando definas un elemento de 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 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

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 subparámetro state determina si la nota se 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 de un elemento y hover requiere que el usuario coloque el cursor sobre el elemento para ver la nota.

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

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]

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

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

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 trazado

La mayoría de los parámetros que se describen en esta sección corresponden a las opciones de la sección Trazado del editor de visualizaciones para los diagramas de dispersión.

stacking

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

  • normal: Apila barras, líneas y puntos uno encima del 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_null_points

El parámetro show_null_points determina si se deben trazar puntos que tengan valores nulos. Cuando se establece en true, los valores nulos se grafican en cero en el eje Y. Cuando se establece en false, no se trazan los valores nulos y el gráfico dibujará una línea recta entre los puntos antes y después del punto nulo. Si, en cambio, quieres que el gráfico muestre un espacio en blanco para el valor nulo, considera usar discontinuous_nulls: true.

show_null_points: true | false

## default value: true

swap_axes

Intercambia los ejes X e Y de la configuración normal. Cuando se intercambian los ejes, las dimensiones se trazarán en el eje Y y las mediciones se trazarán en el eje X.

swap_axes: true | false

## default value: false

cluster_points

Cuando el parámetro cluster_points se establece en true, Looker agrupa los datos densamente agrupados en bloques de valores de datos. El número de un clúster indica la cantidad de puntos de datos que contiene. Cuando se visualiza un diagrama de dispersión, los usuarios pueden seleccionar un clúster de datos específico para ver los puntos de datos individuales que contiene ese clúster.


cluster_points: true | false

hide_legend

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

hide_legend: true | false

## default value: false

legend_position

Si hide_legend se establece 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 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.

quadrants_enabled

El parámetro quadrants_enabled te permite agregar líneas de cuadrante a un elemento de panel de type: looker_scatter.

Puedes usar los parámetros custom_quadrant_point_x y custom_quadrant_point_y o los parámetros custom_quadrant_value_x y custom_quadrant_value_y para definir las ubicaciones de las líneas de cuadrante verticales y horizontales, y puedes usar el parámetro quadrant_properties para personalizar el color de fondo y la etiqueta de cada cuadrante.


quadrants_enabled: true
  quadrant_properties:
    '0':
      color: ''
      label: 'Quadrant 1 label'
    '1':
      color: ''
      label: 'Quadrant 2 label'
    '2':
      color: ''
      label: 'Quadrant 3 label'
    '3':
      color: ''
      label: 'Quadrant 4 label'

custom_quadrant_point_x

Puedes usar el parámetro custom_quadrant_point_x para definir la ubicación de la línea vertical del cuadrante. Establece el parámetro custom_quadrant_point_x en un valor entre 1 y 9, inclusive. El valor predeterminado es 5, que centra la línea en la visualización.


custom_quadrant_point_x: 6

custom_quadrant_point_y

Puedes usar el parámetro custom_quadrant_point_y para definir la ubicación de la línea horizontal del cuadrante. Establece el parámetro custom_quadrant_point_y en un valor entre 1 y 9, inclusive. El valor predeterminado es 5, que centra la línea en la visualización.


custom_quadrant_point_y: 2

custom_quadrant_value_x

Puedes usar el parámetro custom_quadrant_value_x para establecer la línea vertical del cuadrante en la ubicación de un valor numérico específico en el eje X de tu visualización. Cuando especificas un valor para custom_quadrant_value_x, se anula cualquier valor que se haya proporcionado para el parámetro custom_quadrant_point_x.


custom_quadrant_value_x: 55

custom_quadrant_value_y

Puedes usar el parámetro custom_quadrant_value_y para establecer la línea vertical del cuadrante en la ubicación de un valor numérico específico en el eje Y de tu visualización. Cuando especificas un valor para custom_quadrant_value_y, se anula cualquier valor que se haya proporcionado para el parámetro custom_quadrant_point_y.


custom_quadrant_value_y: 40

quadrant_properties

Cuando el parámetro quadrants_enabled se establece en true, puedes usar el parámetro quadrants_properties para definir etiquetas y colores de fondo personalizados para cada uno de los cuatro cuadrantes. Para definir colores o etiquetas personalizados para cada cuadrante con el parámetro quadrant_properties, usa el parámetro color y el parámetro label con el número adecuado para cada cuadrante:

  • '0': Primer cuadrante
  • '1': Segundo cuadrante
  • '2': Tercer cuadrante
  • '3': Cuarto cuadrante

Por ejemplo, el siguiente LookML establece el color del primer cuadrante en el código hexadecimal #EDEDED y cambia la etiqueta que se mostrará a los usuarios a Primer cuadrante.

quadrant_properties:
  '0':
    color: '#EDEDED'
    label: 'First Quadrant'

Parámetros de series

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 diagramas de dispersión.

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 en la lista, los colores se volverán a usar desde el principio.


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

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

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

point_style

El parámetro point_style especifica cómo aparecen los datos. Las siguientes opciones están disponibles:

  • none: Para gráficos de líneas y de áreas. No se muestran los puntos.
  • circle: Se muestran círculos rellenos.
  • circle_outline: Se muestran círculos con contorno.

size_by_field

Si especificas un campo para size_by_field, se ajustará el tamaño de todos los puntos del gráfico según el campo seleccionado. Ese campo ya no se trazará por separado en el gráfico, a menos que plot_size_by_field se establezca en true. Cuando el tamaño de los puntos se determina según un campo, aparece una clave en la leyenda que indica qué campo determina el tamaño de los puntos.

El parámetro size_by_field no está disponible cuando una tabla de datos contiene un pivote y también una medición que queda fuera de él. Por ejemplo, si tu tabla incluye un cálculo basado en tablas que usa una función pivot_index, size_by_field no estará disponible.


size_by_field: order_items.id

plot_size_by_field

El parámetro plot_size_by_field se puede usar cuando se especifica un campo para size_by_field. Este parámetro determina si el campo que se usa para dimensionar los puntos también se traza por separado. El parámetro de configuración predeterminado es false, lo que significa que el campo no se traza. Cuando este parámetro se establece en true, aparecen puntos adicionales en el gráfico que representan el campo.

series_colors

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

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

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

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

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 recurrirá al esquema de colores 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 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_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 quieras 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.

series_point_styles

Especifica la forma de los puntos del gráfico para los tipos de series de líneas, áreas o dispersión. El series_point_styles se puede establecer en square, diamond, triangle, triangle-down o auto.


series_point_styles:
  users.count: triangle

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 diagramas de dispersión.

show_value_labels

Muestra el valor de una barra, línea o punto junto al dato.

show_value_labels: true | false

## default value: false

custom_value_label_column

Cuando el parámetro show_value_labels se establece en true, se habilita el parámetro custom_value_label_column.

Usa el parámetro custom_value_label_column para personalizar una dimensión que se usará como etiquetas de valor para tu gráfico. Asígnale la dimensión con el formato view_name.field_name.

custom_value_label_column: default | products.category

Si no se establece este parámetro, el valor predeterminado de las etiquetas de valor es la medición que se traza.

Consulta la página de documentación Opciones de gráficos de dispersión para obtener más información y un ejemplo.

labelColor

Si labelColorEnabled se establece en true, usa el parámetro labelColor para especificar un color personalizado para la etiqueta y los porcentajes. Las etiquetas en las que labelPosition se establece en inline aparecerán en el color elegido, y las etiquetas de ambos lados 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 valor con cualquier tamaño de CSS válido, como 10px o 12px.


font_size: 14px

label_value_format

El parámetro label_value_format especifica el formato que se aplicará a un valor, independientemente de cualquier formato aplicado a la dimensión o medición subyacente. El campo acepta el formato al estilo de Excel. Si no se especifica label_value_format, el valor se mostrará en el formato de la dimensión o medición subyacente.

Puedes leer sobre cómo especificar estos formatos en la página de documentación Agrega 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 label_value_format del panel de LookML es el mismo que se usa con el parámetro value_format de LookML, excepto que el parámetro value_format de LookML requiere que la cadena de formato esté entre comillas dobles.


label_value_format: '0.00'

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 inhabilitadas. 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 funcione como se espera con hide_legend: true.

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

hidden_series: ['Yes', 'No']

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

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 con un sombreado claro en el gráfico.

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 diagramas de dispersión.

x_axis_scale

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

  • auto: La escala se inferirá de los datos subyacentes. Esta es la configuración predeterminada.
  • linear: La escala se trazará como datos numéricos lineales. Esto no funcionará si los datos subyacentes no se pueden convertir en números.
  • ordinal: Los datos se trazarán como entradas discretas espaciadas de manera uniforme.
  • time: Los datos se trazarán como tiempo y el eje se etiquetará de forma adecuada. Esto no funcionará si los datos subyacentes no se pueden convertir en fechas.
x_axis_scale: auto | linear | 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 las etiquetas de valor 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 que se deben 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 se establece en time, no se realiza ninguna acción.


x_axis_datetime_label: '%b %d'

Consulta la página de documentación Formato de hora para gráficos para obtener información sobre cómo dar formato a las 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 Opciones de diagramas de dispersión 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 diagramas de dispersión.

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 desciende por 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 la línea 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 partes más pequeñas del eje Y. Sin embargo, es posible que los usuarios puedan acercar partes más pequeñas del eje X si el parámetro x_axis_zoom se establece en true.

Si x_axis_zoom se establece en false, se inhabilita y_axis_zoom.

y_axis_zoom: true | false

# default value: true

Configuración de visualización avanzada

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 Trazar del editor de visualizaciones.

advanced_vis_config

Este parámetro acepta un fragmento de JSON de HighCharts que anula varios parámetros de configuración de visualización y abre nuevas funciones. Consulta la página de documentación Personaliza visualizaciones con el editor de configuración de gráficos para ver ejemplos de uso de JSON de HighCharts 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