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 du 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 des graphiques à barres pour les tableaux de bord LookML.

Utilisation

explore: explore_name { . . . }

Hiérarchie Fichier de modèle explore

Valeur par défaut Aucun Acceptation Nom d'une vue existante ou nom de la explore lorsque vous utilisez from Règles spéciales Les noms explore doivent être uniques dans un modèle donné.

Définition

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

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

Les explorations sont généralement nommées d'après une vue existante. Toutefois, si vous souhaitez créer plusieurs explorations basées sur la même vue, vous pouvez ajouter un paramètre from à l'exploration. Dans ce cas, vous pouvez attribuer à l'exploration n'importe quel nom valide, qui ne doit contenir 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 Clients dans le menu "Explorer" et exécute une requête. Cette exploration customers est basée sur la vue 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 du filtre, et qui spécifient l'ajout de jointures pour l'exploration. Si une exploration inclut une ou plusieurs jointures, celles-ci peuvent comporter des paramètres de jointure qui spécifient le comportement de jointure préféré.

Exemples

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

explore: users {
  # additional explore parameters go here
}

Ajoutez une option Événements au menu "Explorer" en fonction de la vue 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 paramètre view. 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 au nom du fichier de vue dans lequel elle est définie. Ce n'est pas obligatoire : le nom et le nom de fichier de la vue peuvent être différents.

Par exemple, vous avez 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 "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 paramètre view est important.

Lorsque vous utilisez une mesure de type: count dans une exploration, les libellés de visualisation indiquent le nom de la vue plutôt que le mot "Nombre". Pour éviter toute confusion, nous vous recommandons de mettre le nom de votre vue au pluriel, de sélectionner Afficher le nom complet du champ sous Série dans les paramètres de visualisation ou d'utiliser un view_label avec une version au pluriel du nom de votre vue.

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 verrez généralement explore utilisé avec des options supplémentaires. Par exemple, il est très courant de join des vues supplémentaires dans 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 une join dans une exploration sont indiqués sur la page Paramètres de jointure.