exploration

Cette page fait référence au paramètre explore, qui fait partie d'un modèle.

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

explore peut également être utilisé dans un élément de tableau de bord. Un exemple représentatif de son utilisation est fourni sur la page de documentation Paramètres de graphique à colonnes pour les tableaux de bord LookML.

Utilisation

explore: explore_name { . . . }
Hiérarchie
explore
Valeur par défaut
Aucun

Acceptation
Nom d'une vue existante ou nom de l'explore lors de l'utilisation de from

Règles spéciales
Les noms d'explore doivent être uniques dans un modèle donné

Définition

Si un signe plus (+) précède le nom de l'exploration, par exemple explore: +orders, il s'agit d'un affinage d'une exploration. Pour en savoir plus, consultez la page de documentation Affinages LookML.

explore ajoute une vue existante au menu des explorations de Looker, comme décrit sur la page de documentation Termes et concepts LookML. Il est recommandé de définir le paramètre explore dans un fichier de modèle.

Les explorations sont généralement nommées d'après une vue existante. Toutefois, si vous souhaitez disposer de plusieurs explorations basées sur la même vue, vous pouvez ajouter un from paramètre à l'exploration. Dans ce cas, l'exploration peut recevoir n'importe quel nom valide, qui ne comprend que des lettres minuscules (a-z), des chiffres (0-9) et des traits de soulignement.

explore joue un rôle important dans le code SQL généré par Looker. Supposons qu'un utilisateur sélectionne Customers (Clients) dans le menu "Explore" (Explorer) et exécute une requête. Cette exploration customers est basée sur la vue appelée customers, qui est associée à une table de base de données. Cette table est placée dans la clause FROM de la requête SQL de l'utilisateur.

explore peut avoir de nombreux paramètres enfants qui affectent l'affichage et le comportement des filtres, et qui spécifient l'ajout de jointures pour l'exploration. Si une exploration inclut une ou plusieurs jointures, ces jointures peuvent avoir des paramètres de jointure qui spécifient le comportement de jointure préféré.

Exemples

Ajoutez une option au menu "Explore" (Explorer) en fonction de la vue appelée users :

explore: users {
  # additional explore parameters go here
}

Ajoutez une option au menu "Explore" (Explorer) appelée Events (Événements) en fonction de la vue appelée user_events :

explore: events {
  from: user_events
}

Difficultés courantes

explore doit faire référence à un nom de vue existant

Vous ne pouvez pas utiliser le paramètre explore pour définir la table de base de données, les dimensions, les mesures et les autres champs qui font partie d'une vue. Vous devez d'abord définir une vue à l'aide du view paramètre. Vous pouvez ensuite faire référence au nom de cette vue dans explore.

explore doit faire référence au nom de la vue, et non à son nom de fichier

En règle générale, le nom d'une vue est identique à celui du fichier de vue dans lequel elle est définie. Ce n'est pas obligatoire : le nom de la vue et le nom du fichier de vue peuvent être différents.

Par exemple, vous disposez d'une vue appelée users définie dans un fichier appelé company_users. Le fichier de vue company_users se présente comme suit :

view: users { ... }

Vous ajoutez ensuite la vue users au menu "Explore" (Explorer) avec :

explore: users { ... }

Même si la vue users se trouve dans un fichier appelé company_users, le nom du fichier n'a pas d'importance. Seul le nom de la vue dans le view paramètre compte.

Lorsque vous utilisez une mesure de type: count dans une exploration, la visualisation libelle les valeurs résultantes avec le nom de la vue plutôt qu'avec le mot « Count ». Pour éviter toute confusion, nous vous recommandons de mettre le nom de la vue au pluriel, en sélectionnant Show Full Field Name (Afficher le nom complet du champ) dans l'onglet Series (Série) des paramètres de visualisation, ou en utilisant un paramètre view_label contenant le nom de la vue au pluriel.

Bon à savoir

explore est généralement utilisé avec des paramètres supplémentaires

Il est possible d'utiliser explore seul, sans paramètres supplémentaires. En pratique, vous voyez généralement explore utilisé avec des options supplémentaires. Par exemple, il est très courant d'utiliser join pour ajouter des vues à une exploration.

Tous les paramètres supplémentaires associés à explore sont affichés sur la page Paramètres d'exploration. Les paramètres qui peuvent être utilisés pour un join dans une exploration sont affichés sur la page Paramètres de jointure.