requête

Cette page fait référence au paramètre query qui fait partie d'une exploration.

query peut également être utilisé dans une table agrégée, comme décrit sur la page de documentation du paramètre aggregate_table.

Utilisation

explore: explore_name {
  query: query_name {
    dimensions: [dimension1, dimension2, ... ]
    measures: [measure1, measure2, ... ]
    label: "Display Name in Field Picker"
    description: "Information about this query"
    pivots: [dimension1, dimension2, ... ]
    sorts: [field1: asc, field2: desc, ... ]
    filters: [field1: "value1", field2: "value2", ... ]
    limit: 100
  }
  ...
}
Hiérarchie
explore
query
Valeur par défaut
Aucun

Acceptation
Nom de la requête et des sous-paramètres permettant de la définir

Définition

Vous pouvez utiliser le paramètre query pour créer des analyses modélisées pour une exploration. Les analyses modélisées sont listées dans la section Démarrage rapide d'une exploration vide ou dans le pop-up "Démarrage rapide" après l'exécution d'une exploration. Pour en savoir plus sur son fonctionnement, consultez la section Exemple sur cette page.

Les analyses modélisées sont utiles aux utilisateurs Looker débutants, car vous pouvez spécifier des éléments tels que les dimensions, les mesures, les filtres et les tableaux croisés dynamiques qui peuvent être les plus pertinents et les plus instructifs.

Définir une requête dans LookML

Au lieu de créer le LookML de la requête de toutes pièces, vous pouvez utiliser une exploration pour créer le LookML de base de la requête. Pour en savoir plus, consultez la section suivante, Obtenir le LookML d'une requête à partir d'un Explore.

Le paramètre query comporte les sous-paramètres suivants :

Nom du paramètre Description Exemple
label Ajoute éventuellement un libellé pour query. Le libellé est ce qui s'affiche dans le sélecteur de champ d'Explore pour la requête. label: "Weekly Sales Totals"
description  Ajoute éventuellement une description de la requête pour informer vos utilisateurs. Dans l'exploration, une icône d'information s'affiche pour les requêtes comportant une description. Le texte de la description s'affiche lorsqu'un utilisateur pointe sur l'icône d'information. description: "Total value of all sales per day"
dimensions Liste des dimensions de l'onglet "Explorer" à inclure dans votre requête, séparées par une virgule. Le champ dimensions utilise la syntaxe suivante :

dimensions: [dimension1, dimension2, ...] 		dimensions:

  [orders.created_month, orders.country]
measures Liste des mesures de l'onglet "Explorer" à inclure dans votre requête, séparées par une virgule. Le champ measures utilise la syntaxe suivante :

measures: [measure1, measure2, ...] 		measures:

  [orders.count]
filters  Ajoute éventuellement des filtres à un query. Les filtres sont ajoutés à la clause WHERE du code SQL qui génère la requête.

Le champ filters utilise la syntaxe suivante :

filters: [field_name_1: "value1", field_name_2: "value2", ...] 		filters: [orders.country: "United States", orders.state: "California"]
limit  Le cas échéant, définit la limite de lignes de la requête. limit: 10
sorts Spécifie éventuellement les champs de tri et le sens du tri (croissant ou décroissant) pour query.

Le champ sorts utilise la syntaxe suivante :

sorts: [field1: asc|desc, field2: asc|desc, ...] 		sorts: [order_items.total_sales: asc]
pivots  Permet, le cas échéant, de croiser les résultats selon les dimensions spécifiées de la requête. Le champ pivots utilise la syntaxe suivante :

pivots: [dimension1, dimension2, ...]

NOTE : Les champs spécifiés dans le paramètre pivots doivent également être spécifiés dans le paramètre dimensions de la requête. 		pivots: [created_quarter]
timezone Non compatible Le paramètre timezone n'est pas compatible avec le paramètre query, qui est un sous-paramètre de explore. Un query sous explore utilise le même fuseau horaire que le explore.

Extraire le code LookML d'une requête à partir d'une exploration

Pour gagner du temps, les développeurs Looker peuvent emprunter la fonctionnalité utilisée pour générer le code LookML aggregate_table à partir d'une exploration, puis copier le code LookML de la requête de table agrégée et l'utiliser comme point de départ pour le code LookML d'analyse modélisée.

Lorsque vous copiez le code LookML d'une table agrégée, vous copiez également certains paramètres dont vous n'avez pas besoin pour le code LookML de votre requête modélisée. Plus précisément, une fois que vous avez copié le code LookML de la table agrégée, vous devez supprimer les paramètres aggregate_table et materialization, car ils ne s'appliquent qu'aux tables agrégées. (Pour en savoir plus sur ces paramètres, consultez la page de documentation sur le paramètre aggregate_table.)

De plus, le paramètre query du tableau agrégé n'est compatible qu'avec un sous-ensemble des paramètres acceptés par les requêtes Explore modélisées. Cela signifie qu'une fois que vous avez copié le code LookML query de la table agrégée, vous pouvez utiliser des paramètres supplémentaires pour votre requête modélisée. Pour obtenir la liste complète des paramètres compatibles avec les requêtes modélisées, consultez la section Définir une requête dans LookML sur cette page.

Pour utiliser une exploration afin d'obtenir une base pour votre requête LookML modélisée :

  1. Dans votre exploration, sélectionnez tous les champs et filtres à inclure dans votre requête modélisée.
  2. Sélectionnez Exécuter pour obtenir les résultats.

  3. Sélectionnez Afficher le code LookML dans le menu en forme de roue dentée "Actions sur les explorations". Cette option n'est disponible que pour les développeurs Looker.

  4. Sélectionnez l'onglet Tableau agrégé.

  5. Looker fournit le code LookML pour un affinement d'exploration pour une table agrégée. Nous pouvons utiliser le LookML query de la table agrégée et le modifier pour une requête d'exploration modélisée. Copiez le code LookML et collez-le dans le fichier de modèle associé, indiqué dans le commentaire précédant l'affinage de l'exploration. Si l'exploration est définie dans un fichier d'exploration distinct et non dans un fichier de modèle, vous pouvez ajouter l'affinage au fichier de l'exploration au lieu du fichier de modèle.

    Vous pouvez ensuite modifier la table agrégée LookML à utiliser pour une requête modélisée :

  6. Ne conservez que le paramètre query et ses sous-paramètres. Supprimez les paramètres aggregate_table et materialization, car ils ne s'appliquent qu'aux tables agrégées.

  7. Attribuez un nom à la requête. Comme indiqué dans la section Exemple de cette page, la syntaxe est la suivante :

    query: query_name

  8. Vous pouvez également renseigner d'autres paramètres pour votre requête modélisée. Pour obtenir la liste complète des paramètres compatibles avec les requêtes modélisées, consultez la section Définir une requête dans LookML sur cette page.

Exemple

Cet exemple crée une requête modélisée order_count_by_month pour l'exploration order_items :


explore: +order_items {
  query: order_count_by_month {
     description: "Number of orders placed by month in 2019"
     dimensions: [orders.created_month]
      measures: [orders.count]
     filters: [orders.created_date: "2019"]
    }
  }

Les utilisateurs peuvent exécuter l'analyse de démarrage rapide dans la section Démarrage rapide de l'exploration Éléments de commande.