Paramètres d'exploration

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

Une exploration sert de point de départ à une requête dans l'application Looker. Les explorations référencent des vues et peuvent 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. Cliquez dessus pour accéder à la page correspondante._ Lorsqu'un paramètre peut être défini sur l'une des nombreuses 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 l'exploration)	Spécifie les explorations qui seront étendues par cette exploration
extension (pour l'exploration)	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 l'exploration)	Limite les champs disponibles dans une exploration à partir de sa vue de base et via ses jointures
tags (pour l'exploration)	Spécifie le texte qui peut être transmis à d'autres applications
Paramètres d'affichage
description (pour l'exploration)	Ajoute une description à une exploration visible par les utilisateurs dans l'interface utilisateur
group_label (pour l'exploration)	Crée un libellé de groupe à utiliser comme en-tête dans le menu Exploration
hidden (pour l'exploration)	Masque une exploration dans le menu Exploration
label (pour l'exploration)	Modifie l'apparence d'une exploration dans le menu Exploration
query (pour l'exploration)	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 l'exploration)	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 l'exploration)	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 l'exploration)	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 l'exploration)	Modifie les paramètres de mise en cache d'une exploration
persist_with (pour l'exploration)	Désigne le groupe de données à utiliser pour les règles de mise en cache d'une exploration
required_access_grants (pour l'exploration)	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 l'exploration)	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 l'exploration)	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 de table agrégée
aggregate_table	Crée une table agrégée afin d'utiliser la détection des agrégations pour les requêtes sur l'exploration. Pour en savoir plus sur le paramètre aggregate_table, consultez la page du paramètre aggregate_table. Pour obtenir une présentation de la détection des agrégations, consultez la page de documentation Détection des agrégations.
query	Définit la requête pour le tableau cumulé. 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 ajouter un affinage à l'exploration existante. Pour en savoir plus et découvrir des cas d'utilisation, consultez la page de documentation Affinages LookML.
final	Indique que l'affinage actuel est l'affinage final autorisé pour l'exploration. Pour en savoir plus et découvrir des cas d'utilisation, consultez la page de documentation Affinages LookML.
Paramètres à éviter
access_filter_fields	Supprimé de la version 6.0 Remplacé par access_filter