Paramètres des tableaux pour les tableaux de bord LookML

Cette page explique comment ajouter et personnaliser un élément de tableau de bord LookML type: looker_grid avec des paramètres de tableau de bord LookML dans un fichier dashboard.lkml.

Pour savoir comment créer un tableau à l'aide de l'interface utilisateur Looker, consultez la page de documentation Options du tableau.

Exemple d'utilisation


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

## QUERY PARAMETERS
model: model_name
explore: explore_name
fields: [view_name.field_name, view_name.field_name, …]
dimensions: [view_name.field_name, view_name.field_name, …]
measures: [view_name.field_name, view_name.field_name, …]
sorts: [view_name.field_name asc | desc, view_name.field_name, …]
pivots: [view_name.field_name, view_name.field_name, …]
fill_fields: [view_name.field_name, view_name.field_name, …]
subtotals: [view_name.field_name, view_name.field_name, …]
total: true | false
row_total: right | left | false
limit: N
column_limit: N
filters:
  view_name.field_name: 'Looker filter expression' | 'filter value'
filter_expression:  'Looker custom filter expression'
listen:
  dashboard_filter_name: view_name.field_name
query_timezone: 'specific timezone' | user_timezone
analysis_config: # can only be used when the Forecasting Labs feature is enabled
  forecasting:
  - confidence_interval: N
    field_name: view_name.field_name
    forecast_n: N
    forecast_interval: day | month | a time frame with dimension fill
    seasonality: N
merged_queries:
- 'primary query definition'
- 'next source query definition'
  join_fields:
  - field_name: view_name.field_name
    source_field_name: view_name.field_name

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

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

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

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

Définition des paramètres

Nom du paramètre Description
Paramètres de base
name (pour les éléments) Crée un élément.
title (pour les éléments) Modifie la façon dont le nom d'un élément s'affiche pour les utilisateurs
type (pour les éléments) Détermine le type de visualisation à utiliser dans l'élément.
height (pour les éléments) Définit la hauteur d'un élément en unités tile_size pour les tableaux de bord layout: tile et layout: static
width (pour les éléments) Définit la largeur d'un élément en unités tile_size pour les tableaux de bord layout: tile et layout: static
top Définit la position de haut en bas d'un élément en unités tile_size pour les tableaux de bord layout: static
left Définit la position de gauche à droite d'un élément en unités tile_size pour les tableaux de bord layout: static.
row Définit la position de haut en bas d'un élément en nombre de lignes pour les tableaux de bord layout: newspaper
col Définit la position de gauche à droite d'un élément en unités de colonnes pour les tableaux de bord layout: newspaper
refresh (pour les éléments) Définit l'intervalle auquel l'élément est automatiquement actualisé
note_state Définit si la note sera réduite ou développée si elle est trop grande pour tenir sur une seule ligne dans la largeur de l'élément.
note_display Définit l'emplacement de la note sur un élément
note_text Spécifie le texte qui s'affiche dans la note.
Paramètres de requête
model Définit le modèle à utiliser pour la requête de l'élément
explore (pour les éléments) Définit l'exploration à utiliser pour la requête de l'élément.
fields Définit les champs à utiliser pour la requête de l'élément. Vous pouvez l'utiliser à la place de dimensions et measures.
dimensions Définit les dimensions à utiliser pour la requête de l'élément
measures Définit les mesures à utiliser pour la requête de l'élément.
sorts Définit les tris à utiliser pour la requête de l'élément
pivots Définit les dimensions à pivoter pour la requête de l'élément
fill_fields Définit les dimensions qui utilisent l'option Remplissage de la dimension.
subtotals Définit les champs pour lesquels un sous-total est calculé.
total Indique si les totaux des colonnes sont affichés pour une visualisation sous forme de tableau.
row_total Indique si les totaux des lignes sont affichés pour une visualisation sous forme de tableau.
limit Définit la limite de lignes à utiliser pour la requête de l'élément
column_limit Définit la limite de colonnes à utiliser pour la requête de l'élément
filters (pour les éléments) Définit les filtres qui ne peuvent pas être modifiés pour la requête de l'élément.
filter_expression Définit un filtre personnalisé qui ne peut pas être modifié pour la requête de l'élément.
listen Définit les filtres qui peuvent être modifiés pour la requête de l'élément, si des filters (pour le tableau de bord) ont été créés.
query_timezone Définit le fuseau horaire à utiliser lors de l'exécution de la requête.
analysis_config Ajouté dans la version 21.14 Définit l'analyse des prévisions à effectuer lorsque la requête est exécutée. Nécessite l'activation de la fonctionnalité expérimentale Prévision.
merged_queries Définit une requête Fusion de résultats.
Paramètres de colonne
auto_size_all_columns Redimensionne automatiquement chaque colonne du tableau en fonction de la largeur de son en-tête ou de la valeur de données la plus longue, selon la plus grande des deux.
column_order Ordonne les colonnes du tableau
pinned_columns Définit les colonnes à épingler ou à figer sur la gauche du tableau.
Paramètres du graphique
table_theme Applique l'une des cinq options de couleur à une visualisation sous forme de tableau.
show_row_numbers Indique s'il faut afficher un numéro de ligne au début de chaque ligne du tableau.
hide_totals Définir si une visualisation de tableau affiche les totaux des colonnes
hide_row_totals Définir si une visualisation sous forme de tableau affiche les totaux des lignes
transpose Indique s'il faut transposer les lignes du tableau en colonnes.
hidden_fields Spécifie les champs à utiliser dans la requête, mais à masquer dans le graphique.
limit_displayed_rows Affiche ou masque les lignes d'une visualisation en fonction de leur position dans les résultats.
Paramètres de série
truncate_text Raccourcit les en-têtes de colonne et le texte des cellules de données à l'aide d'un point de suspension (…).
show_view_names Affiche le nom de la vue ainsi que le nom du champ pour chaque en-tête de colonne
size_to_fit Redimensionne automatiquement la largeur de toutes les colonnes pour que le tableau s'adapte parfaitement à la largeur de l'élément dans lequel il est affiché.
dynamic_fields Inclure des calculs de table ou des champs personnalisés dans votre tableau
series_labels Spécifie un libellé personnalisé pour chaque colonne de la visualisation.
series_column_widths Spécifie des largeurs spécifiques pour les colonnes de la visualisation
series_cell_visualizations Indique si les colonnes utilisent l'option de visualisation Visualisation des cellules. Ce paramètre comporte les sous-paramètres is_active, palette et value_display.
series_text_format Spécifie la mise en page du texte des cellules pour chaque colonne. Ce paramètre comporte les sous-paramètres fg_color, bg_color, bold, italic et align.
series_collapsed Indique si une colonne comportant des sous-totaux doit apparaître réduite.
series_value_format Définit le format de valeur d'une colonne à l'aide d'un format personnalisé.
Paramètres de mise en forme
color_application Applique des couleurs aux visualisations de cellules et à la mise en forme conditionnelle
header_font_color Applique une couleur de police aux en-têtes de colonne.
header_background_color Applique une couleur à l'arrière-plan des en-têtes de colonne.
header_text_alignment Applique un alignement à gauche, à droite ou au centre aux en-têtes de colonne
header_font_size Applique une taille de police aux en-têtes de colonne.
rows_font_size Applique une taille de police au texte des cellules de données.
enable_conditional_formatting Définit la valeur sur true pour définir des règles de code couleur pour une visualisation sous forme de tableau.
conditional_formatting_include_totals Indique si les totaux sont inclus dans le système de code couleur.
conditional_formatting_include_nulls Indique si les valeurs nulles doivent être représentées par un zéro.
conditional_formatting Utilise conditional_formatting et ses sous-paramètres pour définir les règles qui attribuent des codes couleur à la visualisation de votre tableau.

Paramètres de base

Lorsque vous définissez un élément de tableau de bord LookML, vous devez spécifier des valeurs pour au moins les paramètres name et type. D'autres paramètres de base tels que title, height et width affectent la position et l'apparence d'un élément sur un tableau de bord.

name

Cette section fait référence au paramètre name qui fait partie d'un élément de tableau de bord.

name peut également être utilisé dans un filtre de tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

Chaque déclaration name crée un élément de tableau de bord et lui attribue un nom. Les noms des éléments doivent être uniques. Les noms sont parfois référencés dans le paramètre elements lorsque vous utilisez des tableaux de bord layout: grid.

- name: orders_by_date

title

Cette section fait référence au paramètre title qui fait partie d'un élément de tableau de bord.

title peut également être utilisé dans un tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

title peut également être utilisé dans un filtre de tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

Le paramètre title vous permet de modifier la façon dont le nom d'un élément s'affiche pour les utilisateurs. Si aucun titre n'est spécifié, le titre par défaut est l'élément name.

Considérez l'exemple suivant :

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

Si vous avez utilisé ce format, l'élément Aperçu des ventes s'affichera 1) Aperçu des ventes.

type

Cette section fait référence au paramètre type qui fait partie d'un élément de tableau de bord.

type peut également être utilisé dans un filtre de tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

type peut également être utilisé dans une jointure, comme décrit sur la page de documentation du paramètre type (pour les jointures).

type peut également être utilisé dans une dimension, comme décrit sur la page de documentation Types de dimensions, de filtres et de paramètres.

type peut également être utilisé dans une mesure, comme décrit sur la page de documentation Types de mesures.

Le paramètre type détermine le type de visualisation à utiliser dans l'élément.

- 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

Pour obtenir une présentation des différents types d'éléments de tableau de bord LookML, consultez la page de documentation type (pour les tableaux de bord LookML).

height

Cette section fait référence au paramètre height qui fait partie d'un élément de tableau de bord.

height peut également être utilisé dans une ligne de tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

Pour les tableaux de bord avec des mises en page tile ou static

Le paramètre height définit la hauteur d'un élément, en unités tile_size (qui est définie en pixels), pour les tableaux de bord layout: tile et layout: static.

Par exemple, le code suivant spécifie tile_size: 100 et height: 4, ce qui définit la hauteur de l'élément orders_by_date sur 400 pixels.

- dashboard: sales_overview
  tile_size: 100
  ...

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

Pour les tableaux de bord avec une mise en page newspaper

Le paramètre height définit la hauteur d'un élément, en unités row, pour les tableaux de bord layout: newspaper.

Un tableau de bord avec une mise en page de type journal a une hauteur d'élément par défaut de six lignes, soit environ 300 pixels. La hauteur minimale est d'une ligne pour les tableaux de bord dont le paramètre preferred viewer est défini sur dashboards-next. La hauteur minimale est de deux lignes pour les tableaux de bord dont le paramètre preferred viewer est défini sur dashboards.

Par exemple, le code suivant définit un élément sur 12 lignes de hauteur, soit deux fois plus haut que les autres éléments définis sur la valeur par défaut :

- dashboard: sales_overview
  layout: newspaper
  ...

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

width

Cette section fait référence au paramètre width qui fait partie d'un élément de tableau de bord.

width peut également être utilisé dans un tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

Le paramètre width définit la largeur d'un élément, en unités tile_size, pour les tableaux de bord layout: tile et layout: static.

Par exemple, le code suivant spécifie tile_size: 100 et width: 4, ce qui définit la largeur de l'élément orders_by_date sur 400 pixels.

- dashboard: sales_overview
  tile_size: 100
  ...

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

Le paramètre width définit la largeur d'un élément, en unités de colonnes, pour les tableaux de bord layout: newspaper.

Un tableau de bord avec une mise en page de type journal est défini par défaut sur une largeur de 24 colonnes.

Par exemple, le code suivant définit l'élément sur la moitié de la largeur du tableau de bord :

- dashboard: sales_overview
  layout: newspaper
  ...

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

top

Le paramètre top définit la position de haut en bas d'un élément, en unités tile_size, pour les tableaux de bord layout: static.

Par exemple, le code suivant spécifie tile_size: 100 et top: 4, ce qui positionne le bord supérieur de l'élément orders_by_date à 400 pixels du haut du tableau de bord.

- dashboard: sales_overview
  tile_size: 100
  ...

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

left

Le paramètre left définit la position de gauche à droite d'un élément, en unités tile_size, pour les tableaux de bord layout: static.

Par exemple, le code suivant spécifie tile_size: 100 et left: 4, ce qui positionne le bord gauche de l'élément orders_by_date à 400 pixels du bord gauche du tableau de bord.

- dashboard: sales_overview
  tile_size: 100
  ...

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

row

Pour les tableaux de bord layout: newspaper, le paramètre row définit la ligne sur laquelle le bord supérieur d'un élément est placé.

Un tableau de bord commence par la ligne 0 en haut du tableau de bord. Un tableau de bord avec une mise en page de type journal a une hauteur d'élément par défaut de six lignes. Cela signifie que les éléments de tableau de bord en haut d'un tableau de bord (row: 0) occuperaient par défaut les lignes 0 à 5.

Chaque ligne mesure 50 pixels de haut, ce qui signifie que la hauteur par défaut d'un élément de six lignes est de 300 pixels.

Par exemple, le code suivant définit un élément à placer sur la deuxième ligne d'éléments du tableau de bord, en supposant que les éléments sont définis à la hauteur par défaut :

- dashboard: sales_overview
  layout: newspaper
  ...

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

col

Pour les tableaux de bord layout: newspaper, le paramètre col définit la colonne sur laquelle le bord gauche de l'élément est placé.

Les tableaux de bord sont divisés en 24 colonnes. Un tableau de bord commence par la colonne 0 à gauche. Un tableau de bord avec une mise en page de type journal a une largeur d'élément par défaut de huit colonnes. Cela signifie que les éléments de tableau de bord situés à gauche (col: 0) occuperaient par défaut les colonnes 0 à 7.

Par exemple, le code suivant définit un élément à définir dans la troisième colonne d'éléments du tableau de bord :

- dashboard: sales_overview
  layout: newspaper
  ...

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

refresh

Cette section fait référence au paramètre refresh qui fait partie d'un élément de tableau de bord.

refresh peut également être utilisé dans un tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

Le paramètre refresh permet à un élément de se recharger automatiquement à intervalles réguliers, ce qui permet de récupérer des données récentes. Cela est souvent utile dans les paramètres où un tableau de bord est constamment affiché, par exemple sur un téléviseur de bureau. Notez que le tableau de bord doit être ouvert dans une fenêtre de navigateur pour que ce paramètre ait un effet. Ce paramètre ne s'exécute pas en arrière-plan pour "pré-remplir" le cache du tableau de bord.

Le taux d'actualisation peut être n'importe quel nombre (sans décimales) de secondes, de minutes, d'heures ou de jours. Exemple :

- name: orders_by_date
  refresh: 2 hours

Soyez prudent lorsque vous définissez des intervalles d'actualisation courts. Si la requête à l'origine de l'élément est gourmande en ressources, certains éléments peuvent solliciter votre base de données plus que souhaité.

note_state

Le paramètre note_state définit si une note sera réduite ou développée si elle est trop grande pour tenir sur une seule ligne dans la largeur de l'élément. Si vous sélectionnez collapsed et que la note est trop longue, elle se terminera par des points de suspension cliquables (...) qui permettent de lire la note complète. Si vous choisissez expanded et que la note est longue, elle s'affichera sur plusieurs lignes.

note_display

Le paramètre note_display définit l'emplacement d'une note sur un élément. above place la note en haut d'un élément, below la place en bas d'un élément et hover oblige l'utilisateur à pointer sur une icône ? pour voir la note.

note_text

Le paramètre note_text spécifie le texte affiché dans une note d'élément.

Paramètres de requête

Lorsque vous définissez un élément de tableau de bord LookML, vous devez spécifier des valeurs pour au moins les paramètres de requête model et explore. De plus, au moins un champ doit être spécifié à l'aide du paramètre dimensions, measures ou fields. Vous pouvez également utiliser les autres paramètres de requête décrits dans cette section pour contrôler la façon dont les données sont affichées dans un élément de tableau de bord.

model

Le paramètre model définit le modèle à utiliser pour la requête d'élément. Si aucune valeur n'est spécifiée, la valeur par défaut est le modèle dans lequel réside le tableau de bord.

- name: orders_by_date
  model: ecommerce

Le paramètre model accepte les constantes LookML. Vous pouvez définir une constante dans le fichier manifeste de votre projet, puis utiliser la syntaxe "@{constant_name}" pour définir la constante comme valeur de model. L'utilisation d'une constante vous permet de définir le nom d'un modèle à un seul endroit, ce qui est particulièrement utile si vous mettez à jour le nom d'un modèle utilisé par plusieurs éléments de tableau de bord.

Pour en savoir plus et obtenir un exemple d'utilisation des constantes avec les tableaux de bord LookML, consultez la page de documentation sur le paramètre constant.

explore

Cette section fait référence au paramètre explore qui fait partie d'un élément de tableau de bord.

explore peut également être utilisé dans un modèle, comme décrit sur la page de documentation du paramètre explore.

explore peut également être utilisé dans un filtre de tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

Le paramètre explore définit l'exploration à utiliser pour la requête d'élément.

- name: orders_by_date
  explore: order

Le paramètre explore accepte les constantes LookML. Vous pouvez définir une constante dans le fichier manifeste de votre projet, puis utiliser la syntaxe "@{constant_name}" pour définir la constante comme valeur de explore. L'utilisation d'une constante vous permet de définir le nom d'une exploration à un seul endroit, ce qui est particulièrement utile si vous mettez à jour le nom d'une exploration utilisée par plusieurs éléments de tableau de bord.

Pour en savoir plus et obtenir un exemple d'utilisation des constantes avec les tableaux de bord LookML, consultez la page de documentation sur le paramètre constant.

fields

Le paramètre fields définit les champs à utiliser pour la requête d'élément. Utilisez la syntaxe view_name.dimension_name pour spécifier les champs.

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

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

Si vous utilisez le paramètre fields, vous n'avez pas besoin d'utiliser les paramètres dimensions et measures.

dimensions

Le paramètre dimensions définit la ou les dimensions à utiliser pour la requête d'élément. Utilisez la syntaxe view_name.dimension_name pour spécifier la dimension. N'incluez pas dimensions si la requête n'en comporte pas.

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

Le paramètre measures définit la ou les mesures à utiliser pour la requête d'élément. Utilisez la syntaxe view_name.measure_name pour spécifier la mesure. N'incluez pas measures si la requête n'en comporte pas.

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

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

sorts

Le paramètre sorts définit les tris à utiliser pour la requête d'élément. Le tri principal est indiqué en premier, suivi du tri secondaire, et ainsi de suite. Utilisez la syntaxe view_name.field_name pour spécifier la dimension ou la mesure. N'incluez pas sorts si vous souhaitez utiliser l'ordre de tri par défaut de Looker. Les tris par ordre décroissant sont suivis du suffixe desc, tandis que les tris par ordre croissant n'en ont pas besoin.

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

Le paramètre pivots définit les dimensions à pivoter pour la requête d'élément. Utilisez la syntaxe view_name.dimension_name pour spécifier la dimension. N'incluez pas pivots si la requête n'en comporte pas.

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

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

fill_fields

Le paramètre fill_fields définit les dimensions qui utilisent l'option Remplissage de la dimension. Utilisez la syntaxe view_name.dimension_name pour spécifier les dimensions.

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

subtotals

Le paramètre subtotals définit les dimensions qui utilisent l'option Sous-totaux. Utilisez la syntaxe view_name.dimension_name pour spécifier les dimensions.

subtotals: [products.department, distribution_centers.name]

total

Le paramètre total permet de définir si une ligne de totaux doit s'afficher au bas du tableau. Pour en savoir plus, consultez Afficher les totaux.

total: true | false

## default value: false

row_total

Le paramètre row_total définit si une colonne de totaux s'affiche à droite ou à gauche du tableau. Ne fonctionne que si un pivot est présent. Pour en savoir plus, consultez Afficher les totaux.

row_total: right | left | false

## default value: false

limit

Le paramètre limit définit la limite de lignes à utiliser pour la requête d'élément. Cette limite s'applique au nombre de lignes avant l'application des tableaux croisés dynamiques.

- name: orders_by_date
  limit: 100

column_limit

Le paramètre column_limit définit la limite de colonnes à utiliser pour la requête d'élément. La limite s'applique au nombre de colonnes après l'application des tableaux croisés dynamiques.

- name: orders_by_date
  column_limit: 100

filters

Cette section fait référence au paramètre filters qui fait partie d'un élément de tableau de bord.

filters peut également être utilisé dans un tableau de bord, comme décrit sur la page de documentation Paramètres du tableau de bord.

filters peut également être utilisé dans une mesure, comme décrit sur la page de documentation du paramètre filters.

Le paramètre filters définit les filtres non modifiables à utiliser pour la requête de l'élément. Si vous souhaitez que les utilisateurs puissent modifier les filtres dans le tableau de bord, vous devez les configurer à l'aide de filters pour les tableaux de bord, puis les appliquer aux éléments à l'aide de listen.

La syntaxe de filters est la suivante :

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

Chaque filtre peut accepter une expression de filtre Looker ou une constante de valeur. Vous pouvez également utiliser les variables Liquid _localization ou _user_attributes dans l'expression de filtre pour obtenir des valeurs de filtre flexibles.

filter_expression

Le paramètre filter_expression définit un filtre personnalisé non modifiable pour la requête de l'élément. Si vous souhaitez que les utilisateurs puissent modifier les filtres dans le tableau de bord, vous devez les configurer à l'aide de filters pour les tableaux de bord, puis les appliquer aux éléments à l'aide de listen.

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

La page de documentation Expressions de filtre Looker liste les expressions de filtre Looker.

listen

Les filtres de tableau de bord permettent aux lecteurs d'affiner de manière interactive les données affichées dans les éléments du tableau de bord. Définissez des filtres de tableau de bord avec le paramètre filters pour les tableaux de bord LookML. Ensuite, utilisez le paramètre listen pour associer les éléments du tableau de bord au filtre du tableau de bord.

Voici la syntaxe à utiliser pour listen :

- 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

Ajoutez le paramètre listen à un élément, puis indiquez le nom du filtre, suivi d'un deux-points et d'une référence au champ auquel le filtre doit s'appliquer, en utilisant la syntaxe view_name.field_name. Par exemple, vous pouvez créer un filtre appelé Date qui demande à l'utilisateur de saisir une date dans le champ de filtre de l'UI. Vous pouvez ensuite appliquer la valeur saisie par l'utilisateur à l'élément orders_by_date comme suit :

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

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

Pour obtenir d'autres exemples d'utilisation des paramètres filters et listen afin d'appliquer des filtres de tableau de bord à des éléments de tableau de bord individuels, consultez Créer des tableaux de bord LookML.

query_timezone

Le paramètre query_timezone spécifie le fuseau horaire dans lequel la requête sera exécutée. Les options de fuseau horaire sont indiquées sur la page de documentation Valeurs pour timezone. Si vous souhaitez que la requête s'exécute en utilisant le fuseau horaire du lecteur, vous pouvez attribuer la valeur user_timezone.

- name: orders_by_date
  query_timezone: America/Los Angeles

- name: orders_by_customer
  query_timezone: user_timezone

analysis_config

Le paramètre analysis_config et ses sous-paramètres décrivent toute analyse de requête à utiliser avec la visualisation, à partir de Looker 21.14. La fonctionnalité expérimentale Prévision doit être activée pour effectuer des analyses sur les visualisations.

Les sous-paramètres suivants peuvent être utilisés pour définir des analyses :

Vous pouvez créer une prévision à l'aide d'une syntaxe comme celle-ci :


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

forecasting

forecasting est un type d'analyse qui applique une prévision à une visualisation. La prévision permet aux analystes d'ajouter rapidement des projections de données à des requêtes d'exploration nouvelles ou existantes afin d'aider les utilisateurs à prédire et à surveiller des points de données spécifiques.

Pour en savoir plus, consultez la page de documentation Prévisions dans les visualisations.

Pour ajouter des prévisions aux visualisations, la fonctionnalité de laboratoire Prévisions doit être activée.

confidence_interval

confidence_interval définit les limites des valeurs de données prévues, qui sont saisies sous forme d'expressions décimales de pourcentages. confidence_interval est facultatif et vide par défaut.


confidence_interval: 0.99 | 0.98 | 0.95 | 0.90 | 0.80

Consultez la section Intervalle de prédiction sur la page de documentation Prévisions dans les visualisations.

Pour ajouter des prévisions aux visualisations, la fonctionnalité de laboratoire Prévisions doit être activée.

field_name

field_name spécifie les noms des mesures (jusqu'à cinq) à inclure dans les prévisions.


field_name: view_name.field_name

forecast_n

forecast_n spécifie la durée de la prévision.


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

Consultez la section Longueur de la page de documentation Prévisions dans les visualisations.

Pour ajouter des prévisions aux visualisations, la fonctionnalité de laboratoire Prévisions doit être activée.

forecast_interval

forecast_interval définit l'intervalle de durée pour lequel prévoir les valeurs de données. forecast_interval est renseigné automatiquement en fonction de la dimension "Période" dans la requête Explorer.


forecast_interval: day | month # a timeframe with dimension fill

Consultez la page de documentation Length.

Pour ajouter des prévisions aux visualisations, la fonctionnalité de laboratoire Prévisions doit être activée.

seasonality

seasonality permet aux analystes de tenir compte des cycles connus ou des tendances répétitives des données dans une prévision. seasonality est facultatif et vide par défaut.


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

Le paramètre de saisonnalité Automatique est représenté par une valeur seasonality vide.

Consultez la section Saisonnier de la page de documentation Prévisions dans les visualisations.

Pour ajouter des prévisions aux visualisations, la fonctionnalité de laboratoire Prévisions doit être activée.

merged_queries

Le paramètre merged_queries vous permet de combiner les résultats de plusieurs requêtes dans un seul élément de tableau de bord. Définissez chaque requête source dans le paramètre merged_queries de l'élément et utilisez le sous-paramètre join_fields pour spécifier comment les résultats doivent être fusionnés.

L'exemple de code LookML suivant crée un élément de résultats fusionnés type: looker_grid. Dans cet exemple, le paramètre merged_queries est utilisé pour créer un élément de tableau de bord qui combine les données de deux requêtes distinctes dans un seul tableau :

- 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

Dans cet exemple, l'élément de tableau de bord combine les données de deux requêtes sources basées sur l'exploration users dans le modèle ecommerce. La requête principale inclut les champs users.state, users.count et users.city, et trie les résultats par le champ users.count. La deuxième requête source inclut les champs users.state et users.city, et trie les résultats par le champ users.state.

Le paramètre join_field fusionne les requêtes sources en fonction des valeurs correspondantes dans les champs users.state et users.city.

Le paramètre listen applique un filtre State aux deux requêtes, ce qui permet aux lecteurs du tableau de bord d'affiner les résultats de la requête affichés dans le bloc du tableau de bord en sélectionnant un état spécifique.

Exemple : Fusionner des données d'entreprise

Imaginons que vous souhaitiez créer une requête fusionnée qui combine des informations sur les entreprises provenant de deux explorations différentes : company_info et companies. Vous souhaitez joindre les requêtes sur les champs ipo.stock_symbol, companies.name et companies.contact_email de chaque exploration pour créer une requête qui renvoie les résultats pour le nom de l'entreprise, l'adresse e-mail de contact de l'entreprise, l'année d'introduction en bourse, le symbole boursier, le nombre d'employés et le nombre de postes. Vous pouvez définir l'élément de requête fusionnée dans LookML comme suit :

- 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

Appliquer des filtres aux éléments de requête fusionnés

L'exemple précédent d'élément de requête fusionné montre comment appliquer des filtres codés en dur directement dans chaque requête source à l'aide du paramètre filters. Par exemple, les filtres companies.contact_email: "-NULL" et ipo.valuation_amount: NOT NULL de la requête principale limitent les résultats aux entreprises qui disposent d'adresses e-mail et de valorisations valides. Ces filtres au niveau de la requête préfiltrent les données avant de fusionner les requêtes. L'utilisateur ne peut pas les modifier.

Vous pouvez également appliquer des filtres de tableau de bord aux éléments de requête fusionnés à l'aide du paramètre listen dans la définition de chaque requête source. Par exemple, supposons que vous ayez un filtre de tableau de bord nommé Industry que vous avez défini au niveau du tableau de bord à l'aide du paramètre filters pour les tableaux de bord 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

Pour appliquer le filtre Industry au champ companies.industry dans les deux requêtes sources, ajoutez le paramètre listen à chacune des définitions de requête source de la requête fusionnée, comme suit :

listen:
  Industry: companies.industry

Par exemple, l'exemple de code suivant ajoute le filtre Industry aux deux requêtes sources dans l'élément de résultats fusionnés de l'exemple précédent.

- 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

Grâce à cette nouveauté, lorsqu'un utilisateur interagira avec le filtre de tableau de bord Industry, la requête source correspondante dans l'élément de requête fusionnée sera filtrée en conséquence.

Paramètres de colonne

Les paramètres suivants correspondent à la possibilité de déplacer et d'épingler des colonnes dans les tableaux.

auto_size_all_columns

Le paramètre auto_size_all_columns redimensionne automatiquement chaque colonne du tableau en fonction de la largeur de son en-tête ou de la valeur de données la plus longue, selon la plus grande des deux. Ce paramètre remplace les paramètres series_column_widths et size_to_fit, s'ils sont définis.

- name: orders_by_date
  auto_size_all_columns: true

column_order

Le paramètre column_order définit l'ordre des colonnes dans le tableau.

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

pinned_columns

Le paramètre pinned_columns définit les colonnes épinglées à gauche du tableau.

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

Paramètres du graphique

Les paramètres suivants correspondent aux options du menu Tracer de l'éditeur de visualisations pour les tableaux.

table_theme

Utilisez le paramètre table_theme pour appliquer l'une des options de couleur de tableau suivantes à un élément de tableau :

  • editable : la table comporte des dimensions bleues, des mesures orange et des calculs de tables verts.
  • white : l'en-tête du tableau est blanc, les lignes de données alternent entre le blanc et le gris, et le texte est noir.
  • gray : l'en-tête du tableau est gris, les lignes de données alternent entre le blanc et le gris clair, et le texte est gris foncé.
  • transparent : l'en-tête du tableau est totalement transparent, les lignes de données alternent entre totalement transparent et gris translucide, et la couleur du texte passe du noir au blanc selon la couleur d'arrière-plan qui apparaît. Définir table_theme sur transparent peut être utile lorsque vous utilisez un tableau de bord intégré personnalisé afin que la couleur d'arrière-plan de la tuile soit visible à travers la visualisation.
  • unstyled : l'en-tête et les lignes de données du tableau sont blancs, et le texte est noir.

table_theme: editable | white | gray | transparent | unstyled

show_row_numbers

Le paramètre show_row_numbers permet de définir si un numéro de ligne doit être affiché au début de chaque ligne du tableau.


show_row_numbers: true | false

hide_totals

Si votre exploration inclut des totaux de colonnes, hide_totals indique si la visualisation affiche les totaux.


hide_totals: true | false

hide_row_totals

Si votre exploration inclut des totaux de ligne, hide_row_totals indique si les totaux de ligne s'affichent dans la visualisation.


hide_row_totals: true | false

transpose

Le paramètre transpose vous permet de transposer les lignes d'un tableau en colonnes. Il accepte true ou false.

- name: orders_by_date
  transpose: true

hidden_fields

Le paramètre hidden_fields indique les champs utilisés dans la requête, le cas échéant, mais masqués dans le graphique. Tous les champs masqués s'affichent dans la section "Table de données" d'une exploration.

hidden_fields: [inventory_items.count, distribution_centers.id]

limit_displayed_rows

Le paramètre limit_displayed_rows vous permet d'afficher ou de masquer des lignes dans une visualisation, en fonction de leur position dans les résultats. Par exemple, si votre visualisation affiche une moyenne mobile sur sept jours, vous pouvez masquer les six premières lignes. Si vous définissez ce paramètre sur true, vous pouvez spécifier les valeurs et les positions dans la visualisation auxquelles il s'applique à l'aide du paramètre limit_displays_rows_values et de ses sous-paramètres.

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

limit_displayed_rows_values

Utilisez le paramètre limit_displayed_rows_values et ses sous-paramètres show_hide, first_last et num_rows avec limit_displayed_rows pour spécifier les lignes à afficher ou à masquer dans une visualisation. Pour voir un exemple d'utilisation, consultez la section limit_displayed_rows.

show_hide

Le sous-paramètre show_hide permet de définir si certaines lignes doivent être masquées dans la visualisation. Définissez show_hide sur show pour n'afficher qu'un nombre limité de lignes dans la visualisation, et définissez show_hide sur hide pour exclure certaines lignes de la visualisation.

first_last

Le sous-paramètre first_last indique si les lignes à masquer ou à afficher seront les premières ou les dernières de l'ensemble de résultats. Si vous définissez first_last sur first, les premières lignes sont affichées ou masquées. Si vous définissez first_last sur last, les dernières lignes sont affichées ou masquées.

num_rows

Le sous-paramètre num_rows définit le nombre de lignes à masquer ou à afficher. Par exemple, num_rows: '10' affichera ou masquera les 10 premières ou dernières lignes de l'ensemble de résultats de la visualisation.

Paramètres de série

Les paramètres suivants correspondent aux options du menu Série de l'éditeur de visualisations pour les tableaux.

truncate_text

Le paramètre truncate_text permet de déterminer si les en-têtes de colonne et le texte des cellules de données doivent être abrégés par des points de suspension (…).


truncate_text: true | false

show_view_names

Le paramètre show_view_names détermine si les noms de vues sont affichés dans les libellés des graphiques, tels que les noms d'axes et de colonnes.

show_view_names: true | false

## default value: true

size_to_fit

Le paramètre size_to_fit permet de définir si la largeur de toutes les colonnes doit être ajustée pour que le tableau s'adapte parfaitement à la largeur de l'élément dans lequel il est affiché. Si le paramètre auto_size_all_columns est défini sur true, il remplace size_to_fit.


size_to_fit: true | false

dynamic_fields

Le paramètre dynamic_fields et ses sous-paramètres décrivent les calculs de table ou les champs personnalisés à utiliser avec la visualisation. Vous devez disposer de l'autorisation de créer des champs personnalisés pour ajouter un description de 255 caractères maximum ou utiliser calculation_type pour les groupes personnalisés ou les bins personnalisés. Vous devez disposer de l'autorisation de créer des calculs de table pour ajouter une description de 255 caractères maximum aux calculs de table ou pour utiliser calculation_type pour les calculs rapides.

Les sous-paramètres suivants peuvent être utilisés pour définir des champs dynamiques :

Vous pouvez créer un calcul de table à l'aide d'une syntaxe comme celle-ci :

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

Vous pouvez créer des calculs rapides pour plusieurs types de calculs à l'aide d'une syntaxe comme celle-ci :

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

Vous pouvez créer une mesure personnalisée à utiliser dans votre visualisation à l'aide d'une syntaxe comme celle-ci :

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

Vous pouvez créer une mesure personnalisée filtrée à utiliser dans votre visualisation à l'aide d'une syntaxe comme celle-ci :

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

Vous pouvez créer une dimension personnalisée à utiliser dans votre visualisation à l'aide d'une syntaxe comme celle-ci :

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

Vous pouvez créer des groupes personnalisés pour une dimension à utiliser dans votre visualisation à l'aide d'une syntaxe comme celle-ci :

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

Vous pouvez créer des bins personnalisés pour une dimension à utiliser dans votre visualisation à l'aide d'une syntaxe comme celle-ci :

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

Vous pouvez ajouter plusieurs champs dynamiques à votre élément. Vous n'avez pas besoin d'ajouter des calculs de tableau au paramètre fields pour qu'ils apparaissent dans la visualisation, mais vous devez ajouter d'autres types de champs dynamiques à fields pour qu'ils s'affichent.

table_calculation

Si vous définissez un calcul de table, le sous-paramètre table_calculation nomme le calcul de table. Il s'agit du nom à utiliser lorsque vous faites référence au calcul de tableau dans LookML.

measure

Le sous-paramètre measure définit le nom d'une mesure personnalisée ou d'une mesure personnalisée filtrée. Il s'agit du nom que vous utilisez pour faire référence à la mesure dans LookML.

dimension

Le sous-paramètre dimension définit le nom d'une dimension personnalisée. Il s'agit du nom à utiliser pour faire référence à la dimension dans LookML.

label

Le sous-paramètre label définit le titre du champ dynamique tel que vous souhaitez qu'il apparaisse dans la visualisation. Il peut être identique ou différent du nom indiqué dans les sous-paramètres table_calculation, measure ou dimension.

based_on

Si vous utilisez une mesure personnalisée ou une mesure personnalisée filtrée, le sous-paramètre based_on identifie la mesure sur laquelle elle est basée, en utilisant la syntaxe view_name.field_name.

type

Si vous utilisez une mesure personnalisée, le sous-paramètre type identifie le type d'agrégation. Il accepte count_distinct, sum, average, min, max ou median.

description

Vous pouvez ajouter une description de 255 caractères maximum à n'importe quel champ personnalisé ou calcul de tableau à l'aide du sous-paramètre description. Looker affiche la description lorsque l'utilisateur clique sur l'icône d'informations à droite du nom de champ dans le sélecteur de champs, et lorsqu'il pointe sur le nom de la colonne d'une table ou d'une visualisation sous forme de tableau dans une exploration, un tableau de bord ou une présentation.

expression

Si vous utilisez un calcul de tableau, le sous-paramètre expression définit l'expression Looker utilisée pour créer le calcul de tableau.

filter_expression

Si vous utilisez une mesure filtrée personnalisée, le sous-paramètre filter_expression définit l'expression Looker utilisée pour filtrer la mesure.

value_format

Le sous-paramètre facultatif value_format définit le format de valeur d'un champ dynamique lorsque vous utilisez la mise en forme personnalisée. Si vous souhaitez utiliser un format Looker par défaut, utilisez plutôt value_format_name.

value_format_name

Le sous-paramètre facultatif value_format_name applique un format par défaut au champ dynamique. Si vous souhaitez utiliser un format personnalisé, utilisez plutôt value_format.

calculation_type

Le sous-paramètre calculation_type définit le type de fonction Calcul rapide ou Groupe à utiliser pour créer un calcul de table ou un groupe personnalisé pour une dimension :

Options des calculation_type champs personnalisés :

  • group_by : regroupe les valeurs de dimension sous des libellés fixes personnalisés, en fonction d'une condition personnalisée spécifiée. Semblable à CASE WHEN dans SQL ou au paramètre de champ case LookML.
  • bin : regroupe les valeurs dans des bins ou des niveaux personnalisés pour les dimensions de type numérique et les dimensions personnalisées. Semblable au type de dimension LookML tier.

Options des calculation_type de calcul de tables :

  • percent_of_column_sum : valeur de la ligne divisée par la somme des valeurs de la colonne. Ce calcul inclut uniquement les valeurs dans le tableau de données lorsque la limite de lignes a été atteinte.
  • percent_of_previous : valeur de la ligne actuelle divisée par la valeur de la ligne suivante.
  • percent_difference_from_previous : différence entre la valeur de la ligne actuelle et celle de la ligne suivante, divisée par la valeur de la ligne suivante.
  • rank_of_column : classement de la valeur de la ligne parmi toutes les valeurs de la colonne. Ce calcul inclut uniquement les valeurs dans le tableau de données lorsque la limite de lignes a été atteinte.
  • running_total : somme cumulative de la valeur de la ligne actuelle et de toutes les valeurs précédentes dans la colonne.
  • percent_of_previous_column : pour les champs croisés, la valeur de la colonne actuelle divisée par la valeur de la colonne située à sa gauche.
  • percent_change_from_previous_column : pour les champs croisés, la différence entre la valeur de la colonne active et la valeur de la colonne de gauche, divisée par la valeur de la colonne de gauche.
  • percent_of_row : pour les champs croisés, pourcentage de la valeur de la colonne actuelle divisé par la somme des lignes de ce champ.
  • running_row_total : pour les champs croisés, la somme cumulée de la colonne active et de toutes les colonnes précédentes sur cette ligne.

args pour les groupes personnalisés

Si vous utilisez des groupes personnalisés pour une dimension, args spécifie les arguments permettant d'appliquer des libellés fixes aux valeurs de dimension. args utilise le format suivant :

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

Vous pouvez ajouter autant de conditions label et filter que nécessaire, en fonction du nombre de groupes souhaité.

Pour référence, consultez l'exemple précédent.

args pour les bins personnalisés

Si vous utilisez des bins personnalisés pour une dimension numérique, args spécifie les arguments permettant d'appliquer des niveaux fixes aux valeurs de dimension. args utilise le format suivant :

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

Pour référence, consultez l'exemple précédent.

args pour les calculs rapides

Le sous-paramètre args vous permet de spécifier les noms des champs numériques que vous utilisez pour un calcul rapide. Un argument se présente sous la forme suivante :

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

Pour référence, consultez l'exemple précédent.

_kind_hint

Le sous-paramètre _kind_hint facultatif indique si le champ dynamique renvoie une dimension ou une mesure. Accepte les valeurs dimension et measure.

_type_hint

Le sous-paramètre facultatif _type_hint identifie le type de données que l'expression du champ dynamique doit générer.

is_disabled

Le sous-paramètre facultatif is_disabled indique si un calcul de tableau apparaît dans la visualisation et dans l'exploration sous-jacente. Accepte les valeurs true et false.

series_labels

Définissez les libellés d'une ou de plusieurs séries en fonction de leur nom, à l'aide de paires name: label.

Pour un graphique croisé, les noms de série sont les noms de tableau croisé dynamique.

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

Pour un graphique comportant plusieurs mesures, les noms de série correspondent aux noms des champs de mesure.

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

series_column_widths

Définissez la largeur d'une ou de plusieurs colonnes en fonction du nom de la série. Si le paramètre auto_size_all_columns est défini sur true, il remplace series_column_widths.

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

series_cell_visualizations

Indiquez si une ou plusieurs colonnes utilisent l'option Visualisation des cellules en indiquant le nom de la série au format view_name.field_name. series_cell_visualizations comporte les sous-paramètres is_active, palette et value_display.

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

is_active

Le sous-paramètre facultatif is_active accepte true ou false pour indiquer si les visualisations de barres sont activées pour cette série. Si is_active n'est pas défini, la valeur par défaut est true.

palette

Le sous-paramètre palette est facultatif. Si elle n'est pas utilisée, la palette sera définie par défaut sur une palette divergente dans la collection de couleurs par défaut de l'instance.

Si palette est utilisé, les paramètres enfants palette_id et collection_id appliquent les couleurs d'une palette spécifique aux visualisations de barres. Pour palette_id, vous devez utiliser l'ID d'une palette séquentielle ou divergente. Pour en savoir plus sur les ID de palette et les ID de collection de couleurs, consultez la section color_application.

palette comporte un paramètre enfant alternatif, custom_colors, qui définit deux à cinq couleurs personnalisées à utiliser pour les barres :

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

value_display

Le sous-paramètre facultatif value_display accepte true ou false pour indiquer si les valeurs de chaque cellule de données sont affichées avec la visualisation de la cellule. Si value_display n'est pas défini, la valeur par défaut est true.

series_text_format

Le paramètre series_text_format et ses sous-paramètres spécifient la mise en page du texte des cellules pour chaque colonne. La série à mettre en forme est indiquée à l'aide de la syntaxe view_name.field_name, et les sous-paramètres décrivent la mise en forme.

Tous les sous-paramètres sont facultatifs. N'utilisez que ceux dont vous avez besoin.

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

fg_color

Le sous-paramètre fg_color indique la couleur de la police du texte de la cellule. La valeur de couleur peut prendre la forme d'une chaîne hexadécimale, telle que #2ca6cd, ou d'une chaîne de couleur nommée CSS, telle que mediumblue.

bg_color

Le sous-paramètre bg_color indique la couleur d'arrière-plan de la cellule. La valeur de couleur peut prendre la forme d'une chaîne hexadécimale, telle que #2ca6cd, ou d'une chaîne de couleur nommée CSS, telle que mediumblue.

bold

Le sous-paramètre bold indique si le texte de la cellule est en gras et accepte true ou false.

italic

Le sous-paramètre italic indique si le texte de la cellule est en italique et accepte true ou false.

align

Le sous-paramètre align indique l'alignement du texte de la cellule et accepte les valeurs left, center ou right.

series_collapsed

Le paramètre series_collapsed définit s'il faut réduire ou développer les sous-totaux d'une série spécifique. Identifiez la série à l'aide de la syntaxe view_name.field_name et de true ou false.

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

Si la colonne est réduite, les éléments individuels qui composent le sous-total s'affichent lorsque vous cliquez sur la flèche à gauche de la cellule de données.

series_value_format

Le paramètre series_value_format spécifie la mise en forme à appliquer à une série, indépendamment de toute mise en forme appliquée à la dimension ou à la mesure sous-jacente. Si series_value_format n'est pas spécifié, la valeur est affichée dans le format de la dimension ou de la mesure sous-jacente.

Identifiez la série à mettre en forme à l'aide de la syntaxe view_name.field_name.

Le sous-paramètre format_string vous permet de définir le format de la série à l'aide d'une mise en forme de type Excel.

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

Vous pouvez également définir la mise en forme comme suit :


series_value_format:
  order_items.count: "00#"

La mise en forme utilisée dans le sous-paramètre format_string est la même que celle utilisée avec le paramètre LookML value_format. Pour savoir comment spécifier ces formats, consultez la page de documentation Ajout d'une mise en forme personnalisée à des champs numériques.

Paramètres de mise en forme

Les paramètres suivants correspondent aux options du menu Mise en forme de l'éditeur de visualisations pour les tableaux.

color_application

Le paramètre color_application et ses sous-paramètres collection_id et palette_id peuvent être utilisés pour appliquer une collection et une palette de couleurs spécifiques à un élément de tableau de bord. Pour obtenir une présentation des collections de couleurs natives de Looker, consultez la page de documentation Collections de couleurs.

Si vous disposez de l'ID de la collection et de l'ID de la palette que vous souhaitez utiliser, vous pouvez les saisir dans les sous-paramètres collection_id et palette_id. Un ID de collection ou de palette peut être un code alphanumérique ou être basé sur le nom de la collection de couleurs. Des codes alphanumériques sont utilisés pour les collections natives de Looker. Elles sont spécifiques à l'instance et se présentent comme suit :


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

Les collections de couleurs personnalisées utilisent des ID de collection et de palette basés sur le nom de la collection de couleurs. Elles sont portables d'une instance à l'autre et se présentent comme suit :


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

Vous pouvez également utiliser l'UI pour trouver les couleurs, les collections ou les palettes de votre choix, puis générer le code LookML pour les ajouter à votre tableau de bord. Accédez à un contenu défini par l'utilisateur (comme une présentation, un tableau de bord ou une exploration), puis appliquez les couleurs, la collection ou la palette de votre choix à la visualisation de ce contenu à l'aide de l'UI. Une fois que vous avez fait cela, vous pouvez suivre la procédure pour obtenir le LookML du tableau de bord, copier le LookML produit et le coller dans la section color_application.

header_font_color

Le paramètre header_font_color applique une couleur de police aux en-têtes de colonne.

La valeur de couleur peut prendre une chaîne hexadécimale, telle que #2ca6cd, ou une chaîne de couleur nommée CSS, telle que mediumblue.


header_font_color: purple

La couleur par défaut dépend du thème du tableau défini à l'aide du paramètre table_theme.

header_background_color

Le paramètre header_background_color applique une couleur aux en-têtes de colonne d'arrière-plan.

La valeur de couleur peut prendre une chaîne hexadécimale, telle que #2ca6cd, ou une chaîne de couleur nommée CSS, telle que mediumblue.


header_background_color: #add8e6

La couleur par défaut dépend du thème du tableau défini à l'aide du paramètre table_theme.

header_text_alignment

Le paramètre header_text_alignment applique l'alignement left, right ou center aux en-têtes de colonne.


header_text_alignment: center

L'alignement par défaut est left.

header_font_size

Le paramètre header_font_size applique une taille de police comprise entre 1 et 99 aux en-têtes de colonne.


header_font_size: 16

La taille par défaut des polices d'en-tête et de ligne est 12.

rows_font_size

Le paramètre rows_font_size applique une taille de police comprise entre 1 et 99 au texte des cellules de données, mais pas aux en-têtes de colonnes.


rows_font_size: 8

La taille par défaut des polices d'en-tête et de ligne est 12.

enable_conditional_formatting

Définir enable_conditional_formatting sur true vous permet de définir des règles qui attribuent un code couleur à la visualisation de votre tableau, soit sur une échelle, soit en spécifiant des valeurs qui vous intéressent.


enable_conditional_formatting: true | false

conditional_formatting_include_totals

Si enable_conditional_formatting est défini sur true, conditional_formatting_include_totals indique si les totaux sont inclus dans le système de code couleur.


conditional_formatting_include_totals: true | false

conditional_formatting_include_nulls

Si enable_conditional_formatting est défini sur true, conditional_formatting_include_nulls indique si les valeurs nulles doivent être représentées par des zéros.


conditional_formatting_include_nulls: true | false

conditional_formatting

Lorsque enable_conditional_formatting est défini sur true, utilisez le paramètre conditional_formatting pour définir les règles qui attribuent des couleurs à la visualisation de votre tableau. Pour chaque règle de mise en forme conditionnelle, vous pouvez spécifier des paramètres à l'aide des paramètres suivants :

Voici un exemple de règle de mise en forme conditionnelle :


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

type

Le paramètre type indique si les valeurs doivent être codées en couleur selon une échelle ou en fonction d'une condition logique.

Si vous attribuez des codes couleur à des valeurs sur une échelle, vous pouvez définir type sur along a scale....

Si vous codez les valeurs en couleur en fonction d'une condition logique, vous pouvez spécifier l'une des valeurs suivantes pour type, ainsi qu'une valeur pour value :

  • equal to : la règle s'applique aux valeurs égales au nombre spécifié pour value.
  • not equal to : la règle s'applique aux valeurs qui ne sont pas égales au nombre spécifié pour value.
  • greater than : la règle s'applique aux valeurs supérieures au nombre spécifié pour value.
  • less than : la règle s'applique aux valeurs inférieures au nombre spécifié pour value.
  • between : la règle s'applique aux valeurs comprises entre les deux nombres spécifiés pour value.
  • not between : la règle s'applique aux valeurs qui ne sont pas comprises entre les deux nombres spécifiés pour value.
  • 'null' : la règle ne s'applique qu'aux valeurs nulles.
  • not null : la règle ne s'applique qu'aux valeurs non nulles.

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

value

Si vous attribuez des codes couleur aux valeurs en fonction d'une condition logique autre que 'null' ou not null, spécifiez la valeur à laquelle la règle s'applique. Le paramètre value accepte un seul nombre ou, lorsque type est défini sur between ou not between, un ensemble de deux nombres.


value: N | [N, N]

background_color

Si votre code couleur est basé sur une condition logique (type est défini sur une valeur autre que along a scale...), utilisez le paramètre background_color pour spécifier une couleur d'arrière-plan pour les valeurs auxquelles votre règle s'applique.


background_color: "#49cec1"

font_color

Si votre code couleur est basé sur une condition logique (type est défini sur une valeur autre que along a scale...), utilisez le paramètre font_color pour spécifier une couleur de police pour les valeurs auxquelles votre règle s'applique.


font_color: "#1f3e5a"

color_application

Le paramètre color_application et ses sous-paramètres collection_id, palette_id et options peuvent être utilisés pour appliquer une collection et une palette de couleurs spécifiques à une règle de mise en forme conditionnelle.

Vous pouvez ajouter des couleurs à un tableau de bord LookML par ID de collection et ID de palette, si vous les avez. Vous pouvez également utiliser l'UI pour trouver les couleurs souhaitées et générer le code LookML permettant de les ajouter à votre tableau de bord. Accédez à un contenu défini par l'utilisateur (comme une présentation, un tableau de bord ou une exploration), puis appliquez les couleurs souhaitées à la visualisation de ce contenu à l'aide de l'UI. Une fois que vous avez fait cela, vous pouvez suivre la procédure pour obtenir le LookML du tableau de bord, copier le LookML produit et le coller dans la section color_application. Pour obtenir une présentation des collections de couleurs prédéfinies de Looker, consultez la page de documentation Collections de couleurs.

Le sous-paramètre options peut être utilisé lorsque vous avez défini type sur along a scale.... Il comporte les paramètres enfants suivants :

  • steps : ce paramètre limite le nombre de couleurs utilisées à la valeur indiquée et sépare les données en ce nombre de groupes. Lorsque ce paramètre n'est pas utilisé, les données sont colorées selon un dégradé couvrant l'ensemble de la palette. Il accepte les valeurs comprises entre 2 et 100.
  • mirror : lorsque ce paramètre est défini sur true, il applique des décalages de couleur égaux de chaque côté de la palette de couleurs pour des valeurs égales de chaque côté d'un point central défini. Il accepte true ou false.
  • constraints : ce paramètre définit la plage de données à laquelle la mise en forme conditionnelle s'applique et définit un point central à utiliser pour l'application de la palette. Il accepte la syntaxe suivante : constraints: {min: {type: number, value: 3}, max: {type: percentile, value: 99}, mid: {type: average}}
  • reverse : ce paramètre détermine s'il faut inverser la palette de couleurs lors de l'application des couleurs. Il accepte true ou false.

bold

Lorsque vous utilisez un code couleur basé sur une condition logique, indiquez si vous souhaitez mettre en gras les valeurs auxquelles votre règle s'applique.


bold: true | false

italic

Lorsque vous utilisez un code couleur basé sur une condition logique, indiquez si vous souhaitez mettre en italique les valeurs auxquelles votre règle s'applique.


italic: true | false

strikethrough

Lorsque vous utilisez un code couleur basé sur une condition logique, indiquez si vous souhaitez appliquer une mise en forme barrée aux valeurs de votre règle.


strikethrough: true | false

fields

Spécifiez les champs auxquels votre règle doit s'appliquer. Par défaut, la règle s'applique à tous les champs numériques.


fields: [ view_name.field_name ]