Paramètres de champ

Cette page contient des liens vers tous les paramètres LookML qui définissent des champs.

Il existe plusieurs types de champs :

• Les dimensions représentent une colonne dans un tableau ou une valeur calculée basée sur une manipulation ou une combinaison de colonnes.
• Les groupes de dimensions ne sont utilisés qu'avec les données temporelles. Ils vous permettent de créer plusieurs dimensions temporelles à la fois.
• Les mesures sont semblables aux fonctions d'agrégation en SQL (par exemple, COUNT, SUM, AVG) et représentent des informations sur plusieurs lignes.
• Les filtres créent un champ réservé au filtrage, dont les utilisateurs peuvent se servir pour fournir une entrée à un filtre basé sur un modèle ou une jointure conditionnelle.
• Les paramètres créent un champ réservé au filtrage, dont les utilisateurs peuvent se servir pour fournir une entrée à une balise {% parameter %} Liquid.

Exemple d'utilisation

Pointez sur le nom d'un paramètre pour afficher une brève description. Cliquez sur le nom d'un paramètre pour accéder à sa page de référence.

Lorsqu'un paramètre peut être défini sur l'une des options spécifiques, la valeur par défaut est indiquée en premier.

## STRUCTURAL PARAMETERS
view: view_name {
  (dimension |dimension_group |measure |filter | parameter):field_name{
    intervals: [interval, interval, …]
    timeframes: [timeframe, timeframe, …]

    # ACTION AND LINKING PARAMETERS
    action: {
      label: "Label to Appear in Action Menu"
      url: "url"
      icon_url: "url"
      form_url: "url"
      param: {
        name:  "name string"
        value:  "value string"
      }
      # Possibly more param definitions
      form_param: {
        name:  "title"
        type: select | string | textarea
        label:  "desired label name"
        required:  yes | no
        default:  "value string"
        option: {
          name:  "name string"
          value:  "value string"
        }
        # Possibly more option definitions
      }
      # Possibly more form_param definitions
    }
    drill_fields: [field_or_set, field_or_set, ...]
    tags: ["string1", "string2", ...]
    link: {
      label: "desired label name;"
      url: "desired_url"
      icon_url: "url_of_an_image_file"
    }
    # Possibly more link definitions
    # DISPLAY PARAMETERS
    alias: [old_field_name, old_field_name, ...]
    alpha_sort: yes | no
    description: "description string"
    group_label:  "desired group label name"
    group_item_label:  "label to use under the group label in the field picker"
    hidden: yes | no
    label: "desired label name"
    label_from_parameter: parameter_name
    order_by_field: dimension_name | dimension_group_name | measure_name 
    style: classic | interval | integer | relational
    view_label: "desired label name"

    # FILTER PARAMETERS
    can_filter: yes | no
    case_sensitive: yes | no
    filters: [dimension: "filter expression", dimension: "filter expression", ...]
    skip_drill_filter: yes | no

    # FILTER SUGGESTION PARAMETERS
    allowed_value: {
      label: "desired label name"
      value: "looker filter expression"
    }
    # Possibly more allowed_value definitions
    bypass_suggest_restrictions: yes | no
    full_suggestions: yes | no
    suggest_dimension: dimension_name
    suggest_explore: explore_name
    suggest_persist_for: "N (seconds | minutes | hours)"
    suggestable: yes | no
    suggestions: ["suggestion string", "suggestion string", "…"]<

    # QUERY PARAMETERS
    allow_approximate_optimization: yes | no
    approximate: yes | no
    approximate_threshold: N
    convert_tz: yes | no
    datatype: epoch | timestamp | datetime | date | yyyymmdd
    fanout_on: repeated_record_name
    precision: N
    primary_key: yes | no
    required_access_grants: [access_grant_name, access_grant_name, ...]
    required_fields: [field_name, field_name, ...]
    sql_distinct_key: SQL expression to define repeated entities ;;

    # VALUE AND FORMATTING PARAMETERS
    case: {
      when: {
        sql: SQL condition ;;
        label: "value"
      }
      # Possibly more when statements
    }
    default_value: "desired default value"
    direction: "row | column"
    end_location_field: dimension_name
    html: HTML expression using Liquid template elements ;;
    list_field: dimension_name

    percentile: Nth percentile
    sql: SQL expression to generate the field value ;;
    sql_end: SQL expression indicating the end time of a duration ;;
    sql_latitude: SQL expression to generate a latitude ;;
    sql_longitude: SQL expression to generate a longitude ;;
    sql_start: SQL expression indicating the start time of a duration ;;
    start_location_field: dimension_name
    synonyms: [synonym1, synonym2, ...]
    tiers: [N, N, ...]
    type: dimension_field_type # For a dimension field
    type: dimension_group_type
# For a dimension_group field
    type: measure_field_type   # For a measure field
    type: filter_field_type    # For a filter field
    type: parameter_field_type # For a parameter field
    string_datatype: unicode # For a dimension field
    units: feet | kilometers | meters | miles | nautical_miles | yards
    value_format: "excel-style formatting string"
    value_format_name: format_name

    # VISUALIZATION PARAMETERS
    allow_fill: yes | no
    map_layer_name: name_of_map_layer
  }
}

Définition des paramètres

• D = Dimension
• DG = Groupe de dimensions
• M = Mesure
• F = Filtrer
• P = Paramètre

Nom du paramètre	Types de champs valides	Description
Paramètres de structure
dimension	D	Crée un champ de dimension.
dimension_group	DG	Crée plusieurs dimensions temporelles à la fois.
filter	F	Crée un champ réservé au filtrage, utilisable dans un filtre basé sur un modèle ou une jointure conditionnelle.
measure	M	Crée un champ de mesure
parameter	P	Crée un champ réservé au filtrage, dont les utilisateurs peuvent se servir pour saisir une valeur dans une balise Liquid {% parameter %}.
intervals	DG	Définit l'ensemble des dimensions de durée que vous souhaitez inclure dans un dimension_group de type: duration.
timeframes	DG	Définit l'ensemble de dimensions de période souhaité dans un dimension_group de type: time
Paramètres d'action et d'association
action	D M	Crée une action de données sur un champ pour permettre à l'utilisateur d'effectuer des tâches dans d'autres outils, directement depuis Looker.
drill_fields	D DG M	Déclare la liste des champs à afficher lorsque l'utilisateur clique sur une mesure ou une dimension pour en voir les détails.
link	D M	Crée des liens vers d'autres ressources Looker et du contenu externe
tags	D DG M F P	Ajoute du texte pouvant être transmis à d'autres applications pour fournir des données sur un champ.
Paramètres d'affichage
alias	D DG M F P	Permet aux URL enregistrées avec d'anciens noms de champs de rester opérationnelles après qu'un champ a été renommé.
alpha_sort	D	Trie les conditions d'un paramètre case dans l'ordre alphabétique.
description	D DG M F P	Ajoute une description à un champ, visible lorsque l'utilisateur passe le curseur sur le champ.
group_label	D DG M F	Regroupe des champs au sein d'une vue dans le sélecteur de champs.
group_item_label	D DG M F	Spécifie un libellé à utiliser pour le champ sous le libellé de son groupe dans le sélecteur de champs.
hidden	D DG M F P	Masque un champ de l'interface Exploration.
label	D DG M F P	Modifie la présentation d'un nom de champ dans le sélecteur de champs.
label_from_parameter	D M	Modifie la présentation d'un nom de champ dans une visualisation en fonction de la valeur saisie pour un parameter.
order_by_field	D DG M	Trie un champ selon les valeurs d'un autre champ. Pris en charge pour les dimensions et les groupes de dimensions Pris en charge pour les mesures
style	D	Modifie l'affichage des niveaux d'une dimension type: tier dans l'interface utilisateur Looker.
view_label	D DG M F P	Modifie les champs visibles au sein d'une vue dans le sélecteur de champs.
Paramètres de filtre
can_filter	D DG M	Détermine si une dimension ou une mesure peut être utilisée comme filtre.
case_sensitive	D F	Indique si les filtres d'une dimension sont sensibles à la casse.
filter	F	Crée un champ réservé au filtrage, utilisable dans un filtre basé sur un modèle.
filters	M	Restreint le calcul d'une mesure en fonction des limitations d'une dimension.
skip_drill_filter	D	Cesse d'ajouter une dimension aux filtres en cas d'exploration détaillée d'une mesure.
Paramètres de suggestion de filtre
allowed_value	P	Spécifie les choix pour un parameter.
bypass_suggest_restrictions	D DG F P	Propose des suggestions aux utilisateurs si sql_always_where est utilisé, mais n'applique pas ces limites aux suggestions.
full_suggestions	D DG F P	Contrôle la façon dont Looker interroge votre base de données pour fournir des suggestions de valeurs de champ dans le filtre d'une exploration. Looker peut utiliser une requête SELECT DISTINCT de base ou la logique complète de l'exploration, y compris les jointures et les paramètres sql_always_where et access_filter.
suggest_dimension	D DG M F P	Base les suggestions proposées pour un champ sur les valeurs d'une autre dimension.
suggest_explore	D DG M F P	Base les suggestions proposées pour un champ sur les valeurs d'une autre exploration.
suggest_persist_for	D F P	Modifie les paramètres de mise en cache des suggestions de filtrage Looker.
suggestable	D DG M F P	Active ou désactive les suggestions pour un champ.
suggestions	D F P	Déclare une liste de valeurs à utiliser pour les suggestions d'un champ.
Paramètres de requête
allow_approximate_optimization	M	Permet d'obtenir des approximations du nombre de valeurs uniques pour les mesures type: count ou type: count_distinct, afin que la mesure puisse être utilisée pour la notoriété globale.
approximate	M	Effectue un décompte approximatif pour une mesure de type: count_distinct. Consultez la page de documentation approximate pour obtenir la liste des dialectes compatibles avec ce paramètre.
approximate_threshold	M	Définit le décompte à partir duquel BigQuery passe d'un décompte exact de valeurs distinctes à un décompte approximatif.
convert_tz	D DG M F P	Désactive la conversion automatique du fuseau horaire d'un champ.
datatype	D DG F M	Indique le type de données temporelles fournies à un champ.
fanout_on	D DG M	Autorise l'accès aux champs répétés Google BigQuery.
precision	M	Spécifie le nombre de décimales à utiliser lors des calculs pour les agrégations symétriques Looker.
primary_key	D	Déclare une dimension comme clé primaire d'une vue.
required_access_grants	D DG F M P	Limite l'accès au champ aux seuls utilisateurs dont les valeurs d'attribut utilisateur correspondent aux droits d'accès.
required_fields	D M	Impose l'ajout de champs supplémentaires à une requête en cas de sélection d'un champ.
sql_distinct_key	M	Définit les entités uniques pour lesquelles une mesure de type: sum_distinct ou type: average_distinct sera calculée.
Paramètres de valeur et de mise en forme
case	D	Crée un ensemble de valeurs discrètes possibles pour une dimension, déterminées par des conditions SQL.
default_value	F P	Définit une valeur par défaut pour les champs de filtrage.
direction	M	Détermine la direction dans laquelle une mesure de type: percent_of_total ou type: running_total est calculée lorsque des tableaux croisés dynamiques sont utilisés.
end_location_field	D	Définit le champ contenant le lieu de destination d'un champ type: distance.
html	D DG M	Modifie la sortie HTML d'un champ en utilisant la fonction de création de modèles Liquid.
list_field	M	Déclare la dimension à partir de laquelle une mesure de type: list sera calculée.
percentile	M	Spécifie la valeur fractionnaire (le centile N) pour une mesure de type: percentile ou type: percentile_distinct.
sql	D DG M F	Détermine le mode de calcul d'un champ.
sql_end	D DG	Définit l'heure de fin d'une durée pour un groupe de dimensions de type "Durée" ou une dimension de type "Durée".
sql_latitude	D	Définit la latitude d'une dimension de type: location
sql_longitude	D	Définit la longitude d'une dimension de type: location
sql_start	D DG	Définit l'heure de début d'une durée pour un groupe de dimensions de type "durée" ou une dimension de type "durée".
start_location_field	D	Définit le champ contenant le lieu de départ d'un champ type: distance.
synonyms	D DG F M P	Spécifie une liste de synonymes de chaînes (mots ou expressions) qui peuvent être utilisés pour aider les grands modèles linguistiques et les développeurs d'applications à comprendre d'autres façons dont les utilisateurs peuvent faire référence à un champ.
tiers	D	Définit les niveaux d'une dimension type: tier.
type (pour une dimension, un filtre ou un paramètre)	D F P	Indique le type de dimension, de filtre ou de paramètre.
type (pour le groupe de dimensions)	DG	Indique le type de groupe de dimensions.
type (pour la mesure)	M	Indique le type de mesure.
string_datatype	D	Spécifie le type de données Unicode pour un champ de type: string pour SQL Server ou MySQL
units	D	Spécifie les unités à utiliser pour un champ de type: distance
value_format	D M	Formate la sortie d'un champ en utilisant des options de style Excel.
value_format_name	D M	Formate la sortie d'un champ en utilisant un format prédéfini ou personnalisé.
Paramètres de visualisation
allow_fill	D DG	Détermine si le remplissage est autorisé ou non pour une dimension.
map_layer_name	D	Spécifie une mise en correspondance entre une valeur de données et une région géographique que vous avez définie sur une carte prédéfinie ou personnalisée.
Paramètres à éviter
decimals	D M	Supprimé 5.4 Remplacé par value_format
format	D M	Supprimé 3.16 Remplacé par value_format