Paramètres d'exploration

Cette page contient des liens vers tous les paramètres LookML qui sont des enfants du paramètre explore.

Une exploration sert de point de départ à une requête dans l'application Looker. Les explorations font référence à des vues et chacune d'elles peut contenir des jointures vers d'autres vues. Les explorations doivent généralement être déclarées dans un fichier de modèle.

Exemple d'utilisation

Pointez sur le nom d'un paramètre pour afficher une brève description, puis cliquez dessus pour accéder à la page correspondante. 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

explore: explore_name {
  extension: required
  extends: [explore_name,  explore_name, ...]
  fields: [field_or_set, field_or_set, ...]
  tags: ["string1", "string2", ...]

  # DISPLAY PARAMETERS
  description: "Description I want"
  group_label: "Label to use as a heading in the Explore menu"
  hidden: yes | no
  label: "desired label"
  query:  {
      # Desired query parameters (described on the query page)      }
  view_label: "Field picker heading I want for the Explore's fields"

  # FILTER PARAMETERS

  access_filter: {
    field: fully_scoped_field
    user_attribute: user_attribute_name
  }

  # Possibly more access_filter declarations

  always_filter: {
    filters: [field_name: "filter expression", field_name: "filter expression", ...]
  }
  case_sensitive: yes | no
  conditionally_filter: {
    filters: [field_name: "filter expression", field_name: "filter expression", ...]
    unless: [field_name, field_name, ...]
  }
  sql_always_having: SQL HAVING condition ;;
  sql_always_where: SQL WHERE condition ;;

  # JOIN PARAMETERS

  always_join: [view_name, view_name, ...]
  join: view_name {
    # Desired join parameters (described on Join Parameters page)
  }
  # Possibly more join declarations

  # QUERY PARAMETERS

  cancel_grouping_fields: [fully_scoped_field, fully_scoped_field, ...]
  from: view_name
  persist_for: "N (seconds | minutes | hours)"
  persist_with: datagroup_name
  required_access_grants: [access_grant_name, access_grant_name, ...]
  sql_table_name: table_name ;;
  sql_preamble: SQL STATEMENT  ;;
  symmetric_aggregates: yes | no
  view_name: view_name

  # AGGREGATE TABLE PARAMETERS

  aggregate_table: table_name {
    query:  {
      # Desired query parameters (described on the aggregate_table page)
    }
    materialization:  {
      # Desired materialization parameters (described on the aggregate_table page)
    }
  }
  # Possibly more aggregate_table declarations
}

## REFINEMENT PARAMETERS

explore: +explore_name {
  final: yes
}

Définition des paramètres

Nom du paramètre	Description
Paramètres de structure
extends (pour Explorer)	Spécifie les explorations qui seront étendues par cette exploration.
extension (pour Explorer)	Indique que l'exploration nécessite une extension et ne peut pas être exposée aux utilisateurs.
explore (pour le modèle)	Présente une vue dans le menu Exploration.
fields (pour Explorer)	Limitez les champs disponibles dans une exploration à partir de sa vue de base et via ses jointures.
tags (pour Explorer)	Spécifie le texte pouvant être transmis à d'autres applications.
Paramètres d'affichage
description (pour Explorer)	Ajoute une description à une exploration visible par les utilisateurs dans l'UI.
group_label (pour Explorer)	Crée un libellé de groupe à utiliser comme en-tête dans le menu "Explorer".
hidden (pour Explorer)	Masque une exploration dans le menu Exploration.
label (pour Explorer)	Modifie l'apparence d'une exploration dans le menu Exploration.
query (pour Explorer)	Crée une requête prédéfinie que les utilisateurs peuvent sélectionner dans le menu "Démarrage rapide" d'une exploration.
view_label (pour Explorer)	Indique le libellé d'un groupe de champs issu de la vue de base d'une exploration dans le sélecteur de champs.
Paramètres de filtre
access_filter	Ajoute des filtres spécifiques à l'utilisateur à une exploration
always_filter	Ajoute à une exploration des filtres que l'utilisateur peut modifier, mais pas retirer.
case_sensitive (pour Explorer)	Indique si les filtres d'une exploration sont sensibles à la casse.
conditionally_filter	Ajoute des filtres à une exploration si l'utilisateur n'ajoute pas son propre filtre depuis une liste définie.
sql_always_having	Insère dans la clause HAVING de la requête des conditions que l'utilisateur ne peut pas modifier ni retirer de l'exploration concernée.
sql_always_where	Insère dans la clause WHERE de la requête des conditions que l'utilisateur ne peut pas modifier ni retirer de l'exploration concernée.
Paramètres de jointure
always_join	Désigne les jointures à appliquer systématiquement à une exploration.
join	Joint une vue à une exploration. Pour en savoir plus sur les jointures et leurs paramètres, consultez la page de référence Paramètres de jointure.
Paramètres de requête
cancel_grouping_fields	Annule la clause GROUP BY lorsque certains champs d'une exploration sont sélectionnés.
from (pour Explorer)	Désigne la vue de base d'une exploration et référence les champs de cette vue sous le nom de l'exploration.
persist_for (pour Explorer)	Modifie les paramètres de mise en cache d'une exploration.
persist_with (pour Explorer)	Désigne le groupe de données à utiliser pour les règles de mise en cache d'une exploration.
required_access_grants (pour Explorer)	Limite l'accès à l'exploration aux seuls utilisateurs dont les valeurs d'attribut utilisateur correspondent aux droits d'accès.
sql_table_name (pour Explorer)	Désigne la table de base de données sur laquelle doit reposer une exploration.
symmetric_aggregates	Indique si les agrégations symétriques sont activées pour une exploration.
view_name (pour Explorer)	Désigne la vue de base d'une exploration et référence les champs de cette vue sous le nom de la vue.
Paramètres des tables agrégées
aggregate_table	Crée une table agrégée afin d'utiliser la reconnaissance d'agrégats pour les requêtes dans l'exploration. Pour en savoir plus sur le paramètre aggregate_table, consultez la page du paramètre aggregate_table. Pour obtenir un aperçu de la reconnaissance d'agrégats, consultez la page de documentation Reconnaissance d'agrégats.
query	Définit la requête pour la table agrégée. Pour en savoir plus sur query et ses sous-paramètres, consultez la page du paramètre aggregate_table.
materialization	Définit la stratégie de persistance pour la table agrégée. Pour en savoir plus sur materialization et ses sous-paramètres, consultez la page du paramètre aggregate_table.
Paramètres d'affinage
explore: +explore_name	Ajoute un signe plus (+) devant le nom d'une exploration existante pour y ajouter un affinement. Pour en savoir plus et découvrir des cas d'utilisation, consultez la page de documentation Affiner le LookML.
final	Indique que l'affinage actuel est le dernier autorisé pour l'exploration. Pour en savoir plus et découvrir des cas d'utilisation, consultez la page de documentation Affiner le LookML.
Paramètres à éviter
access_filter_fields	Supprimé dans la version 6.0 Remplacé par access_filter