Cette page présente les fichiers de modèle et de vue, qui sont des composants clés de la plupart des projets Looker. Les autres types de fichiers de projet sont décrits sur la page Comprendre les autres fichiers de projet. Pour savoir comment accéder aux fichiers d'un projet, consultez la page Consulter et modifier les informations d'un projet.
Fichiers de modèle
Un fichier de modèle spécifie une connexion à une base de données et l'ensemble d'explorations qui utilisent cette connexion. Un fichier de modèle définit également l'exploration elle-même et ses relations avec d'autres vues.
Une exploration est un point de départ pour interroger vos données. En termes SQL, l'exploration est la clause FROM
d'une requête. Les explorations que vous définissez dans le modèle sont visibles par les utilisateurs lorsqu'ils consultent le menu "Explorer" de Looker. Pour en savoir plus sur les explorations, consultez la page Fonctionnement d'un projet dans Looker.
En d'autres termes, c'est dans le fichier de modèle que vous définissez les tables de données à utiliser (en tant que vues incluses) et la manière dont elles doivent être jointes, si nécessaire.
Les explorations sont généralement définies dans un fichier de modèle. Toutefois, vous avez parfois besoin d'un fichier Explorer distinct pour une table dérivée, ou pour étendre ou affiner une exploration à travers plusieurs modèles.
Structure et syntaxe générale
Dans les accolades Explorer, { }
, vous définissez les paramètres de l'exploration. Vous pouvez utiliser les paramètres join
pour joindre d'autres vues à une exploration dans un fichier de modèle.
Vous trouverez ci-dessus l'élément explore
appelé inventory_items
dans le fichier de modèle, ainsi que les vues associées. Cette définition LookML fait apparaître des éléments d'inventaire dans le menu Explorer et joint les données de inventory_items
à products
et distribution_centers
.
Pour en savoir plus sur les structures LookML dans un fichier de modèle, consultez la page de documentation et les termes et concepts de LookML.
Créer des fichiers de modèle
La plupart des développeurs LookML commencent avec un ou plusieurs fichiers de modèle créés automatiquement lorsque le projet LookML est généré à partir d'un ensemble de tables dans une base de données.
Un développeur Looker en mode de développement peut également créer un fichier de modèle vierge comme suit:
- Utiliser l'option Créer un fichier de modèle pour créer le fichier à l'aide de l'IDE Looker (consultez la section Créer des fichiers de la page de documentation Utiliser des dossiers dans l'IDE).
- Utilisez la fonctionnalité de glisser-déposer pour importer le fichier à partir de votre ordinateur (consultez la section Importer des fichiers de la page de documentation Travailler avec des dossiers dans l'IDE). Assurez-vous d'utiliser l'extension
.model.lkml
pour le fichier que vous importez.
Vous pouvez modifier n'importe quel fichier de modèle en ajoutant ou en supprimant des explorations, en spécifiant des jointures et en ajoutant d'autres fonctionnalités.
Si vous devez renommer un modèle ou un objet du modèle, ne renommez pas le fichier ni l'objet lui-même. À la place, utilisez le paramètre
label
oualias
pour modifier le nom affiché du fichier ou de l'objet. Les paramètreslabel
etalias
modifient le nom affiché tout en conservant l'URL sous-jacente utilisée pour les e-mails ou d'autres systèmes.En général, vous devez prendre les précautions nécessaires pour que les modifications du modèle soient non invasives. Si vous devez renommer un modèle ou un objet, mettez à jour toutes les références au modèle ou à l'objet à l'aide de l'outil de validation de contenu.
Si vous supprimez un fichier de modèle, il n'est pas retiré des ensembles de modèles auxquels il appartenait. Si vous créez un fichier de modèle portant le même nom qu'un modèle supprimé, le nouveau modèle est inclus dans tous les ensembles de modèles qui comprenaient le modèle supprimé. Cela peut entraîner un accès indésirable au nouveau fichier de modèle. Les administrateurs Looker peuvent modifier des ensembles de modèles et retirer un modèle supprimé pour éviter ce problème.
En savoir plus sur les paramètres des fichiers de modèle
Pour en savoir plus sur les paramètres LookML dans le fichier de modèle, consultez les pages de documentation sur les paramètres du modèle, les paramètres d'exploration et les paramètres de jointure.
Afficher les fichiers
Un fichier de vue définit généralement une seule "vue" dans Looker. 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 une table à interroger ainsi que les champs (dimensions et mesures) à inclure à partir de cette table.
Structure et syntaxe générale
Dans les accolades de chaque vue, { }
, sont des définitions de champs, qui correspondent généralement à une colonne du tableau sous-jacent ou à un calcul dans Looker. Looker classe la plupart d'entre elles comme des dimensions ou des mesures.
La dimension id
apparaît au-dessus d'un champ dans la vue Éléments de la campagne. Cette définition expose le champ ID pour les requêtes de l'exploration Articles de commande.
Vous pouvez également créer plusieurs dimensions temporelles simultanément à l'aide de groupes de dimensions ou spécifier un filtre pour les utilisateurs à l'aide de champs de filtre. Consultez la page de documentation Afficher les paramètres pour en savoir plus sur les paramètres LookML dans les fichiers de vue.
Pour en savoir plus sur les structures LookML dans un fichier de vue, consultez la page de documentation sur les termes et concepts LookML.
Dimensions
Dans Looker, les champs sont divisés en dimensions et en mesures. Une dimension peut être l'un des deux éléments suivants:
- Colonne de votre table sous-jacente
dimension: first_name {
sql: ${TABLE}.first_name ;;
}
- Valeur calculée basée sur d'autres champs
dimension: full_name {
sql: CONCAT(${first_name}, ' ', ${last_name}) ;;
}
Dans Looker, les dimensions apparaissent toujours dans la clause GROUP BY
du langage SQL que Looker génère.
Dans LookML, vous pouvez définir différents types de dimensions, qui correspondent à différents types ou formats de données.
Mesures
Une mesure calcule des valeurs sur plusieurs lignes. Cela équivaut aux fonctions d'agrégation SQL telles que COUNT()
, SUM()
, AVG()
, MIN()
et MAX()
. Les mesures peuvent également effectuer des transformations simples sur d'autres mesures. Pour en savoir plus, consultez la documentation sur les types de mesures.
Ci-dessus, nous pouvons voir des dimensions et des mesures définies dans le fichier de vue products
.
Créer des fichiers de vue
La plupart des développeurs LookML commencent avec un ou plusieurs fichiers de vue créés automatiquement lorsque le projet LookML est généré à partir d'un ensemble de tables dans une base de données. Cependant, un développeur Looker en mode développement peut ajouter des fichiers de vue à un projet LookML de plusieurs façons:
Créer des fichiers de vue basés sur des tables dans une base de données:
- Générer des fichiers de vue à partir des tables de base de données lorsque vous vous connectez pour la première fois à votre base de données, comme décrit sur la page de documentation Générer un modèle
- Génération de fichiers de vue à partir de tables de base de données pour un projet déjà connecté à une base de données, comme décrit dans la section Ajouter une vue à partir d'une table de base de données existante ci-dessous.
Créer des fichiers de vue vide:
- Utilisez l'option Create View File (Créer un fichier d'affichage) dans l'IDE Looker, comme décrit dans la section Créer des fichiers de la page de documentation Utiliser des dossiers dans l'IDE.
- Utilisez la fonctionnalité de glisser-déposer pour importer le fichier à partir de votre ordinateur, comme indiqué dans la section Importer des fichiers de la page de documentation Travailler avec des dossiers dans l'IDE. Assurez-vous d'utiliser l'extension
.view.lkml
pour le fichier que vous importez.
Créer un fichier de vue pour une table dérivée:
- Commencez par créer un fichier de vue vierge avec l'une des options ci-dessus, puis définissez manuellement votre table dérivée, comme décrit dans la section Définir une table dérivée native dans LookML de la page de documentation Créer des tables dérivées natives.
- Demandez à Looker de créer le LookML d'une table dérivée à partir d'une exploration, comme décrit dans la section Utiliser une exploration pour commencer à définir vos tables dérivées natives de la page de documentation Créer des tables dérivées natives.
- Demander à Looker de créer le LookML d'une table dérivée à partir d'une requête SQL Runner, comme décrit dans la page de documentation Utiliser SQL Runner pour créer des tables dérivées.
Pour utiliser une nouvelle vue, ajoutez-la à votre fichier de modèle à l'aide du paramètre explore
ou utilisez le paramètre join
pour l'associer à une exploration existante dans votre fichier de modèle.
Ajouter une vue à partir d'une table de base de données existante
Vous pouvez créer un fichier de vue à partir d'une table de base de données existante en mode Développement.
Dans un projet, cliquez sur + en haut de la liste des fichiers du projet dans l'IDE Looker, ou cliquez sur le menu d'un dossier pour créer le fichier à l'intérieur du dossier.
Cliquez sur Créer une vue à partir d'une table.
Looker affiche la liste des tables associées à l'une de vos connexions. Pour modifier la connexion, utilisez la liste déroulante Connexion en haut à gauche.
Sélectionnez les tables à partir desquelles vous souhaitez créer des vues en cochant la case située à gauche de leur nom. Vous pouvez réduire et développer les bases de données ou les schémas de cette liste pour accéder à toutes les tables disponibles.
Faites défiler la page jusqu'en bas, puis cliquez sur Créer des vues.
Looker génère des vues contenant LookML pour toutes les colonnes du tableau.
En savoir plus sur les paramètres des fichiers de vue
Pour en savoir plus sur les paramètres de vue, consultez la page Documentation sur les paramètres de vue.
Pour en savoir plus sur les paramètres LookML pour les dimensions, les mesures, les groupes de dimensions et les champs de filtre, consultez la page de documentation Paramètres des champs.