explorer

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

explore peut également être utilisé dans le cadre d'un filtre de tableau de bord, décrit sur la page de documentation des paramètres du tableau de bord.

explore peut également être utilisé dans un élément de tableau de bord. Vous trouverez un exemple représentatif d'utilisation sur la page Paramètres des graphiques à colonnes 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 du explore pour from Règles spéciales Les noms explore doivent être uniques au sein d'un modèle donné

Définition

Si le signe Plus (+) précède le nom Explorer, par exemple explore: +orders, il s'agit d'un raffinement d'une exploration. Pour en savoir plus, consultez la page Affinements MLML.

explore ajoute une vue existante au menu Explorer de Looker, comme décrit sur la page de documentation des 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 que plusieurs explorations soient basées sur la même vue, vous pouvez ajouter un paramètre from à l'exploration. Dans ce cas, vous pouvez attribuer au champ "Explorer" n'importe quel nom valide, qui ne peut inclure 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 qu'il exécute une requête. Cette exploration customers repose 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 le comportement d'affichage et de filtrage, et qui spécifient l'ajout de jointures pour l'exploration. Si une exploration comprend une ou plusieurs jointures, elles peuvent comporter des paramètres de jointure qui spécifient le comportement de jointure souhaité.

Examples

Ajoutez une option au menu Explorer basée sur la vue users:

explore: users {
  # additional explore parameters go here
}

Ajoutez une option Événements au menu "Explorer" basée sur la vue user_events :

explore: events {
  from: user_events
}

Difficultés courantes

explore doit référencer un nom de vue existant

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

explore doit référencer le nom de la vue, et non son nom de fichier

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

Par exemple, vous avez une vue appelée users qui est définie dans un fichier appelé company_users. Le fichier d'affichage company_users ressemble à ceci:

view: users { ... }

Vous ajoutez ensuite la vue users au menu "Explorer" avec les éléments suivants:

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, la visualisation libelle les valeurs obtenues avec le nom de la vue plutôt que le mot "Nombre". Pour éviter toute confusion, nous vous recommandons de donner un nom à 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 nom de version view_label avec une version 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, explore est généralement utilisé avec des options supplémentaires. Par exemple, il est très courant que join vues supplémentaires soient incluses dans une exploration.

Tous les paramètres supplémentaires associés à explore se trouvent ici. Les paramètres pouvant être utilisés pour une join dans une exploration sont disponibles sur cette page.