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

  autogenerate_primary_keys: yes | no
  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_analytic_model_name: analytic_model_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
autogenerate_primary_keys (pour l'exploration)	Active ou désactive la génération automatique de clés primaires.
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.
sql_analytic_model_name (pour l'exploration)	Désigne le modèle analytique intégré à la base de données sur lequel 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