Modéliser vos données en LookML
Découvrez comment utiliser LookML et l'IDE Looker pour modéliser vos données de manière structurée et réutilisable.
Le moyen le plus simple de modéliser vos données dans Looker consiste à laisser Looker lui-même générer automatiquement des fichiers LookML basés sur les tables de votre base de données. Vous pouvez vous entraîner à le faire avec le guide de démarrage rapide Générer un modèle à partir d'exemples de données. Vous trouverez la procédure complète sur la page de documentation Générer un modèle LookML.
L'objectif de ce guide de démarrage rapide est de vous montrer comment ajouter manuellement des fichiers LookML à votre projet et comment créer manuellement des éléments LookML afin de personnaliser votre projet LookML en fonction de vos données et de vos besoins spécifiques. Ce guide de démarrage rapide vous explique comment créer manuellement un fichier de modèle LookML et un fichier de vue LookML, créer une exploration pour votre vue, créer une dimension dans votre fichier de vue et tester votre nouvelle mesure dans l'interface utilisateur d'exploration. Ce guide de démarrage rapide vous explique également comment activer le mode développement, naviguer dans l'IDE Looker et utiliser la fonctionnalité d'aide rapide de l'IDE Looker. Ce guide de démarrage rapide fournit également des liens vers la documentation pertinente pour en savoir plus sur ces sujets.
Pour commencer, ce guide de démarrage rapide utilise l'exemple de projet LookML qui est automatiquement configuré sur les instances Looker (Google Cloud Core).
Avant de commencer
Pour suivre ce guide de démarrage rapide, vous avez besoin des éléments suivants:
- Accès à une instance Looker (Google Cloud Core) :
- L'instance doit inclure l'exemple de projet LookML.
- L'API BigQuery doit être activée pour le projet Google Cloud de l'instance. Le rôle IAM Administrateur Looker est requis pour activer l'API BigQuery.
- Un compte utilisateur Looker disposant du rôle administrateur Looker ou de l'autorisation
develop
.
Activer le mode Développement
Les projets Looker peuvent exister dans l'un des deux modes suivants: mode production et mode développement. Le mode Développement vous permet de modifier des fichiers LookML et de prévisualiser leur impact sur le contenu de votre instance sans affecter l'environnement de production (ce que les autres utilisateurs voient). Pour en savoir plus, consultez la page de documentation Mode développement et mode production.
Pour ce guide de démarrage rapide, vous allez utiliser le mode de développement afin de pouvoir modifier les fichiers LookML et tester vos modifications dans une exploration.
Pour activer le mode développement, procédez comme suit:
- Sur la page d'accueil de Looker (Google Cloud Core), cliquez sur l'icône du menu principal de Looker pour développer le menu de navigation principal, s'il n'est pas déjà développé.
- Activez l'option Mode développement en bas du menu.
Lorsque le mode Développement est activé, Looker affiche la bannière Mode Développement en haut de l'écran.
Accéder à l'exemple de projet LookML dans l'IDE Looker
Un projet LookML est un ensemble de fichiers LookML qui indiquent à Looker comment se connecter à votre base de données, interroger vos données et les présenter dans l'interface utilisateur. Dans ce guide de démarrage rapide, vous allez utiliser l'exemple de projet LookML qui est automatiquement configuré sur les instances Looker (Google Cloud Core).
Pour accéder aux exemples de fichiers de projet LookML dans l'IDE Looker:
- Cliquez sur l'icône du menu principal de Looker, puis sélectionnez Développer si le menu Développer n'est pas déjà affiché.
- Dans le menu Développer, sélectionnez sample_thelook_ecommerce.
Looker ouvre le panneau File Browser (Navigateur de fichiers) de l'IDE Looker et affiche les exemples de fichiers de projet LookML.
Créer un dossier de projet
Pour que les fichiers que vous créez dans ce guide de démarrage rapide soient distincts du reste des fichiers de l'exemple de projet LookML, vous allez créer un dossier de projet pour les fichiers de ce guide.
Pour créer un dossier dans votre projet, procédez comme suit:
- Dans le panneau File Browser (Navigateur de fichiers) de l'IDE Looker, cliquez sur l'icône Add file or folder (Ajouter un fichier ou un dossier) en haut du panneau, puis sélectionnez l'option Create Folder (Créer un dossier) dans le menu Add file or folder (Ajouter un fichier ou un dossier).
Pour le nom du nouveau dossier, saisissez
quickstart
.Cliquez sur Créer.
Looker ajoute le nouveau dossier au panneau File Browser (Navigateur de fichiers) de l'IDE Looker.
Informations supplémentaires sur les dossiers de l'IDE
Pour en savoir plus sur l'utilisation de dossiers dans votre projet LookML, consultez les pages de documentation suivantes:
- Pour créer vos propres dossiers et fichiers à l'avenir, et pour connaître les considérations à prendre en compte lors de la création de dossiers dans votre projet, consultez la page de documentation Gérer les fichiers et les dossiers LookML.
- Pour en savoir plus sur le navigateur de fichiers de l'IDE Looker, consultez la page de documentation Utiliser le navigateur de fichiers de l'IDE.
Créer un fichier de modèle LookML
Un fichier de modèle LookML spécifie une connexion de base de données et l'ensemble des explorations Looker qui utilisent cette connexion. Une exploration est un point de départ pour vos utilisateurs pour interroger vos données dans Looker une fois qu'elles ont été modélisées dans LookML (voir Afficher et interagir avec les explorations dans Looker).
Pour créer un fichier de modèle dans votre projet LookML, procédez comme suit:
- Dans le panneau File Browser (Navigateur de fichiers) de l'IDE Looker, sélectionnez le menu Folder Options (Options de dossier) à trois points pour le dossier
quickstart
que vous avez créé dans la procédure Créer un dossier de projet. - Dans le menu Folder Options (Options des dossiers), sélectionnez Create Model (Créer un modèle).
- Dans la boîte de dialogue Create File (Créer un fichier), saisissez le nom
quickstart_practice
pour le nouveau fichier, puis cliquez sur Create (Créer). Looker crée le fichierquickstart_practice.model
dans le dossierquickstart
et l'ouvre dans l'IDE Looker. Le point bleu à côté du fichier dans le panneau File Browser (Explorateur de fichiers) indique qu'il s'agit d'un nouveau fichier. - Dans le panneau File Browser (Explorateur de fichiers), cliquez sur le dossier
quickstart
pour le développer et afficher le fichierquickstart_practice.model
. - Dans l'IDE Looker, cliquez sur le fichier
quickstart_practice.model
pour l'ouvrir s'il n'est pas déjà ouvert.
Le fichier quickstart_practice.model
contient un exemple de code LookML que vous pouvez utiliser comme point de départ pour votre projet. Pour l'instant, vous pouvez conserver le fichier tel quel. Plus tard dans ce guide de démarrage rapide, vous créerez des explorations dans votre fichier de modèle.
Informations supplémentaires sur les fichiers de modèle
Pour créer vos propres fichiers de modèle à l'avenir, notez les ressources suivantes:
- Pour en savoir plus sur les fichiers de modèle en général, consultez la section Fichiers de modèle de la page de documentation Fichiers de projet LookML.
- Pour connaître la procédure complète et d'autres options de création de fichiers dans votre projet, consultez la page de documentation Gérer les fichiers et les dossiers LookML.
- Pour en savoir plus sur les conventions de nommage des fichiers LookML, consultez la section Avant de commencer: Conventions de nommage importantes pour les fichiers et les dossiers sur la page "Gérer les fichiers et les dossiers LookML".
- Pour en savoir plus sur les paramètres LookML que vous pouvez utiliser dans un fichier de modèle, consultez la page de documentation Paramètres de modèle.
Créer un fichier de vue LookML
Dans LookML, une vue correspond à une seule table de votre base de données ou à une seule table dérivée. Le fichier de vue spécifie la table de votre base de données à interroger et les champs (dimensions et mesures) à inclure dans cette table de base de données. Une fois que vous avez défini un champ dans le fichier de vue, vous pouvez utiliser l'opérateur de substitution $
pour le référencer dans d'autres parties de votre code LookML. Vous pouvez ainsi définir le champ à un seul endroit tout en l'utilisant à plusieurs endroits dans votre projet LookML.
Il existe plusieurs façons de créer un fichier de vue, mais le moyen le plus simple de commencer est de demander à Looker lui-même de générer automatiquement un fichier de vue basé sur un tableau existant dans votre base de données.
Pour que Looker génère un nouveau fichier de vue, procédez comme suit:
- Dans le panneau File Browser (Navigateur de fichiers) de l'IDE Looker, sélectionnez le menu Folder Options (Options de dossier) à trois points pour le dossier
quickstart
que vous avez créé dans la procédure Créer un dossier de projet. - Sélectionnez Créer une vue à partir d'un tableau dans le menu Options des dossiers.
Sur la page Créer des vues à partir de tables, cliquez sur le champ de saisie Enter custom db (Saisir une base de données personnalisée) et saisissez
bigquery-public-data
:Appuyez sur Entrée pour afficher les ensembles de données publics BigQuery.
Faites défiler la liste jusqu'à trouver l'ensemble de données
thelook_ecommerce
.Cliquez sur l'ensemble de données
thelook_ecommerce
pour le développer.Sélectionnez la table
order_items
.Cliquez sur le bouton Créer des vues en bas de la page.
Looker affiche le fichier de vue order_items
dans l'IDE Looker. Dans le panneau "File Browser" (Navigateur de fichiers), le dossier quickstart
est développé et le fichier de vue order_items
est affiché avec un point bleu pour indiquer qu'il s'agit d'un nouveau fichier.
Informations supplémentaires sur les fichiers de vue
Pour créer vos propres fichiers de vue à l'avenir, notez les ressources suivantes:
- Pour en savoir plus sur les fichiers de vue en général, consultez la section Fichiers de vue de la page de documentation Fichiers de projet LookML.
- Pour connaître la procédure complète et d'autres options de création de fichiers dans votre projet, consultez la page de documentation Gérer les fichiers et les dossiers LookML.
- Pour en savoir plus sur la création de fichiers de vue, consultez la section Considérations concernant la création de fichiers de vue sur la page "Gérer les fichiers et les dossiers LookML".
- Pour en savoir plus sur les conventions de nommage des fichiers LookML, consultez la section Avant de commencer: Conventions de nommage importantes pour les fichiers et les dossiers sur la page "Gérer les fichiers et les dossiers LookML".
- Pour en savoir plus sur les paramètres LookML que vous pouvez utiliser dans un fichier de vue, consultez la page de documentation Paramètres de vue.
Aide rapide Looker IDE
Vous avez maintenant créé un fichier de modèle LookML et un fichier de vue LookML. Dans les prochaines étapes de ce guide de démarrage rapide, vous allez commencer à modifier ces fichiers. Avant de commencer à modifier, vous devez vous familiariser avec la fonctionnalité d'aide rapide de l'IDE Looker. Le panneau Aide rapide fournit des explications et des options sur l'emplacement actuel du curseur dans vos fichiers LookML:
- Dans le panneau de l'éditeur de l'IDE, vous pouvez cliquer sur les champs et les paramètres de vos fichiers LookML. Le panneau Aide rapide affiche alors les options et sous-paramètres compatibles pour cet élément LookML.
- Dans le panneau Aide rapide, vous pouvez cliquer sur le nom d'un paramètre pour ouvrir la page de documentation Looker correspondante.
Si le panneau Aide rapide n'est pas déjà ouvert, vous pouvez l'ouvrir en cliquant sur l'icône Aide rapide dans l'IDE Looker:
Créer des explorations pour vos vues
Après avoir effectué les procédures Créer un fichier de modèle LookML et Créer un fichier de vue LookML, vous pouvez définir une exploration pour votre nouveau fichier de vue afin d'utiliser Looker pour interroger les données que vous avez modélisées dans le fichier de vue.
Les explorations sont généralement définies dans un fichier de modèle. (Vous pouvez créer un fichier d'exploration distinct, mais pour les besoins de ce guide de démarrage rapide, vous allez créer l'exploration dans le fichier de modèle.)
Dans le fichier LookML dans lequel vous définissez une exploration, vous devez utiliser le paramètre include
pour pouvoir référencer le fichier de vue dans la définition de l'exploration. Cette procédure vous explique comment procéder.
Pour créer une exploration pour le fichier de vue order_items
, procédez comme suit:
- Dans l'IDE Looker, ouvrez le fichier
quickstart_practice.model
. Dans le fichier
quickstart_practice.model
, remplacez la ligne existante contenant le paramètreinclude
par la ligne suivante:include: "/quickstart/order_items.view"
Ajoutez une ligne sous le paramètre
include
, puis saisissez le code LookML suivant : valeur, que vous pouvez sélectionner dans le champnone explore: order_items {}
Cliquez sur le bouton Save Changes (Enregistrer les modifications) en haut de l'IDE Looker.
Cette exploration est l'exemple le plus basique d'exploration permettant aux utilisateurs d'interroger la vue order_items
. À partir de ce point de départ, vous pouvez développer votre exploration de différentes manières.
Informations supplémentaires sur les explorations
Pour créer vos propres explorations à l'avenir et les développer, consultez les ressources suivantes:
- Pour en savoir plus sur la création d'explorations, consultez la page de documentation Créer et modifier des explorations.
- Pour en savoir plus sur les jointures dans d'autres vues, consultez la page de documentation Utiliser des jointures dans LookML.
- Pour en savoir plus sur les paramètres LookML que vous pouvez utiliser pour une exploration, consultez la page de documentation Paramètres d'exploration.
- Pour en savoir plus sur l'interrogation de données sur une page d'exploration dans l'interface utilisateur de Looker, consultez la page de documentation Afficher et interagir avec les explorations dans Looker.
Créer un champ
Une fois que vous avez créé les fichiers de vue dans la section Créer un fichier de vue LookML de ce guide de démarrage rapide, vous pouvez voir les champs que Looker a créés automatiquement. Lorsque vous créez un fichier de vue basé sur une table de base de données, Looker crée automatiquement des dimensions, des groupes de dimensions et des mesures:
- Une dimension est un champ qui représente un attribut, un fait ou une valeur. Les utilisateurs peuvent le sélectionner dans le sélecteur de champ d'une exploration et l'utiliser pour filtrer une requête. Si le champ ne se trouve pas dans une fonction d'agrégation telle que SUM, COUNT, etc., il s'agit d'une dimension. Looker crée automatiquement une dimension pour chaque colonne de votre table de base de données.
- Un groupe de dimensions permet de créer un ensemble de dimensions basées sur le temps ou la durée en une seule fois. Par exemple, le groupe de dimensions d'une colonne d'horodatage contient des dimensions individuelles pour la date, le mois, le trimestre, l'heure, la semaine et l'année. Looker crée automatiquement un groupe de dimensions pour les champs basés sur le temps qu'il détecte dans votre table de base de données.
- Une mesure est un champ d'une exploration qui représente des informations mesurables sur vos données, telles que des sommes, des totaux, etc. Une mesure est déclarée dans un fichier de vue et peut être de type agrégé ou non. Looker crée automatiquement une mesure de
type:count
pour votre fichier de vue, ce qui équivaut à unCOUNT(*)
en SQL.
Dans cette section, vous allez apprendre à ajouter manuellement votre propre dimension au fichier de vue order_items
.
Pour créer manuellement une dimension dans le fichier de vue order_items
, procédez comme suit:
- Ouvrez le fichier
quickstarts/order_items.view
s'il n'est pas déjà ouvert: dans le panneau File Browser (Explorateur de fichiers) de l'IDE Looker, cliquez sur le dossier quickstart (Premiers pas) pour le développer, puis sur le fichierorder_items.view
pour l'ouvrir. - Dans le fichier
quickstarts/order_items.view
, créez une ligne avant le premier paramètredimension
du fichier. Sur la nouvelle ligne, commencez à saisir
dimension
. À mesure que vous saisissez du texte, l'IDE Looker affiche une liste des paramètres possibles commençant par le texte que vous avez saisi.- Utilisez les touches fléchées pour accéder à l'option
dimension
dans la liste des suggestions. - Appuyez sur Entrée pour insérer le paramètre sélectionné dans votre code LookML.
Looker insère un nouveau paramètre
dimension
sur la nouvelle ligne que vous avez créée.
- Utilisez les touches fléchées pour accéder à l'option
Pour donner un nom à la nouvelle dimension, cliquez dans l'IDE avant le
{}
, puis saisissezshipped_to_delivered_days
.Cliquez dans
{}
et appuyez sur Entrée pour créer une ligne dans{}
.Complétez le code LookML de la nouvelle dimension (vous pouvez copier-coller le code LookML suivant ou le saisir manuellement pour voir comment l'IDE Looker vous fournit des conseils):
dimension: shipped_to_delivered_days { group_label: "Other Dates" type: duration_day sql_start: ${shipped_raw} ;; sql_end: ${delivered_raw} ;; }
En haut de l'IDE Looker, cliquez sur le bouton Save Changes (Enregistrer les modifications).
Looker enregistre le fichier de vue avec votre nouvelle dimension. Pour vos nouvelles lignes dans le fichier, l'IDE Looker mettra en surbrillance les numéros de ligne en vert.
Informations supplémentaires sur les champs LookML
Pour créer vos propres champs à l'avenir, consultez les ressources suivantes:
- Pour en savoir plus sur les champs LookML en général, consultez la page de documentation Référence des champs LookML.
- Pour en savoir plus sur les types de dimensions, de filtres et de paramètres que vous pouvez créer dans un fichier de vue, consultez la page de documentation Types de dimensions, de filtres et de paramètres.
- Pour en savoir plus sur les types de mesures que vous pouvez créer dans un fichier de vue, consultez la page de documentation Types de mesures.
Afficher et tester vos modifications dans l'interface utilisateur de Looker
Si vous avez suivi la procédure Créer des explorations pour vos vues pour créer une exploration pour le fichier de vue order_items
, vous pouvez voir votre nouvelle dimension dans l'interface utilisateur de l'exploration Looker.
Pour afficher et tester vos modifications dans l'exploration de l'interface utilisateur de Looker:
Dans le fichier
quickstarts/order_items.view
de l'IDE Looker, cliquez sur l'icône en forme de flèche Afficher les actions sur le fichier à côté du nom du fichier de vue en haut du panneau de l'éditeur de fichiers, puis sélectionnez l'option Explorer les articles de commande - quickstart_practice.Dans le sélecteur de champ d'exploration Éléments de commande, cliquez sur le libellé de groupe Autres dates pour le développer, puis sur la dimension Jours entre l'expédition et la livraison pour l'ajouter à l'exploration. (Vous pouvez également rechercher la dimension en saisissant
Shipped to Delivered Days
dans le champ de recherche du sélecteur de champs.)Dans le sélecteur de champ de l'exploration Éléments de commande, cliquez sur l'étiquette de groupe Date d'expédition pour la développer, puis sur la dimension Date pour l'ajouter à l'exploration.
Dans le sélecteur de champ de l'exploration Éléments de commande, cliquez sur le libellé de groupe Date de livraison pour le développer, puis sur la dimension Date pour l'ajouter à l'exploration.
Cliquez sur le bouton Exécuter en haut de l'exploration.
Looker exécute la requête et affiche les résultats dans la section Données de l'exploration. Pour chaque ligne, vous pouvez vérifier que la valeur de Jours entre la date d'expédition et la date de livraison des articles de la commande indique le nombre correct de jours entre la valeur de Date d'expédition des articles de la commande et celle de Date de livraison des articles de la commande.
Valider votre code LookML
Pour les besoins de ce guide de démarrage rapide, vous n'avez pas besoin de valider votre LookML. Toutefois, à l'avenir, lorsque vous créerez vos propres projets pour modéliser vos données, il est utile de connaître les outils Looker pour valider votre LookML.
Lorsque vous modifiez votre code LookML, l'IDE de Looker vous avertit de toute erreur de syntaxe non résolue dans un même fichier (voir la page de documentation Présentation de l'IDE de Looker). Vous pouvez également effectuer une validation complète du modèle, qui recherche les erreurs dans votre LookML. Pour en savoir plus, consultez la page de documentation Valider votre code LookML.
Valider vos modifications
Dans ce guide de démarrage rapide, vous utilisez une connexion Git préconfigurée pour l'exemple de projet LookML. Toutefois, à l'avenir, lorsque vous créerez vos propres projets pour modéliser vos données, vous devrez configurer une connexion Git pour votre projet.
Lorsque vous modifiez les fichiers de votre projet LookML, l'IDE Looker affiche différentes opérations pour le bouton Git en haut à droite de l'IDE. Le bouton affiche différentes opérations pour vous guider tout au long du processus de validation de votre LookML et de déploiement de vos modifications en production.
Les fichiers LookML et l'exploration que vous avez consultés dans ce guide de démarrage rapide ne sont disponibles que dans votre branche Git personnelle en mode Développement. Si vous souhaitez rendre ce modèle disponible pour d'autres utilisateurs de votre instance Looker (Google Cloud Core), vous devez commettre vos modifications, fusionner votre branche et déployer la branche de production.
Pour les besoins de ce guide de démarrage rapide, vous ne déploierez pas vos modifications en production. Vous allez plutôt supprimer ces fichiers, comme décrit dans la procédure de nettoyage.
Effectuer un nettoyage
Pour maximiser les performances de Looker, vous ne devez pas déployer de modèles inutiles en production. Pour conserver une branche Git personnelle propre et éviter de déployer accidentellement ces fichiers en production, procédez comme suit pour supprimer les fichiers que vous avez créés dans ce guide de démarrage rapide:
- Cliquez sur l'icône du menu principal de Looker, puis sélectionnez Développer si le menu Développer n'est pas déjà affiché.
- Dans le menu Développer, sélectionnez sample_thelook_ecommerce.
- Dans le panneau File Browser (Navigateur de fichiers) de l'IDE Looker, sélectionnez le menu Folder Options (Options de dossier) à trois points pour le dossier
quickstart
que vous avez créé dans la procédure Créer un dossier de projet. - Sélectionnez Supprimer dans le menu Options des dossiers.
- Dans la fenêtre Supprimer le dossier, cliquez sur Supprimer.
Looker supprime le dossier quickstart
et l'intégralité de son contenu.
Étape suivante
- Générer un modèle LookML
- Présentation de Looker IDE
- Gérer les fichiers et les dossiers LookML
- Types de fichiers dans un projet LookML
- Paramètres d'affichage
- Paramètres du modèle
- Modèles LookML courants
- Utiliser le contrôle des versions et le déploiement
- Comment Looker génère le langage SQL
- Intégrer du code SQL et faire référence à des objets LookML