Un projet LookML est un ensemble de fichiers LookML qui indique à Looker comment se connecter à votre base de données, comment interroger vos données et comment contrôler le comportement de l'interface utilisateur. Vous pouvez accéder aux fichiers de projet LookML dans la section Develop (Développer) de Looker ou depuis l'interface utilisateur, comme décrit dans la page de documentation Accéder aux fichiers de projet LookML.
Les fichiers de projet sont organisés par vos développeurs Looker à l'aide de dossiers dans l'IDE.
Un projet LookML se compose d'au moins un fichier de modèle et un fichier de vue, et éventuellement certains des autres types de fichiers décrits sur cette page. Tous les fichiers de projet ont des extensions, bien que celles-ci soient masquées dans la liste de l'IDE si votre projet n'est pas activé pour les dossiers dans l'IDE.
Cliquez sur les liens suivants pour en savoir plus sur chacun des types de fichiers pouvant être utilisés dans un projet LookML:
- Fichiers de modèle avec l'extension
.model.lkml
- Afficher les fichiers avec l'extension
.view.lkml
- Fichiers de tableau de bord avec l'extension
.dashboard.lookml
- Fichiers de données avec l'extension
.topojson
,.geojson
ou.json
- Fichiers de document avec l'extension
.md
- Fichiers manifestes de projet toujours nommés
manifest.lkml
- Fichiers manifestes de verrouillage avec l'extension
.lkml
- Fichiers de chaînes de paramètres régionaux avec l'extension
.strings.json
- Explorer les fichiers avec l'extension
.explore.lkml
- Fichiers de test de données avec l'extension
.lkml
- Fichiers de raffinement avec l'extension
.lkml
- Autres fichiers dont l'extension ne figure pas dans la liste précédente
Une fois que vous avez créé un projet LookML, vous pouvez accéder aux fichiers du projet et ajouter des fichiers et des dossiers au projet à l'aide de l'IDE Looker.
Fichiers de modèle
Un fichier de modèle spécifie une connexion de base de données et l'ensemble d'explorations qui utilisent cette connexion. Un fichier de modèle définit également les explorations elles-mêmes, ainsi que leurs relations avec les autres vues. Une exploration est un point de départ pour interroger vos données. En termes SQL, une exploration est la clause FROM
d'une requête. Les explorations que vous définissez dans le modèle sont visibles par vos utilisateurs lorsqu'ils consultent le menu Explorer de Looker.
En d'autres termes, c'est dans ce 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.
Consultez la page de documentation Gérer les fichiers et dossiers LookML pour savoir comment créer des fichiers de projet LookML, y compris des fichiers de modèle.
Structure et syntaxe générale
Entre les accolades d'une exploration, { }
, 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.
Dans l'exemple suivant, le code LookML utilisé dans un exemple de fichier de modèle définit une exploration appelée inventory_items
, ainsi que ses vues jointes:
connection: "thelook_events"
explore: inventory_items {
join: products {
type: left_outer
sql_on: ${inventory_items.product_id} = ${products.id} ;;
relationship: many_to_one
}
join: distribution_centers {
type: left_outer
sql_on: ${products.distribution_center_id} = ${distribution_center.id} ;;
relationship: many_to_one
}
}
Avec cette définition LookML, les éléments d'inventaire s'affichent dans la section Explore (Explorer) de la navigation Looker, et les données des vues products
et distribution_centers
sont jointes à la vue inventory_items
.
Pour en savoir plus sur les structures LookML d'un fichier de modèle, consultez la page de documentation Termes et concepts LookML.
Consultez les pages de documentation Paramètres de modèle, Paramètres d'exploration et Paramètres de jointure pour en savoir plus sur les paramètres LookML du fichier de modèle.
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 et les champs (dimensions et mesures) à inclure à partir de cette table afin que les utilisateurs puissent créer des requêtes avec ces champs dans l'interface utilisateur de Looker.
Consultez la page de documentation Gérer les fichiers et dossiers LookML pour savoir comment créer des fichiers de projet LookML, y compris des fichiers de vue.
Structure et syntaxe générale
Entre les accolades de chaque vue, { }
se trouvent les définitions de champ, qui correspondent généralement à une colonne de la table sous-jacente ou à un calcul dans Looker. Looker classe la plupart d'entre elles en tant que dimensions ou mesures.
Dans l'exemple de fichier de vue suivant, le fichier orders.view
inclut des définitions pour les dimensions id
, status
et user_id
, le groupe de dimensions created
et la mesure count
:
view: orders {
sql_table_name: demo_db.orders ;;
drill_fields: [id]
dimension: id {
primary_key: yes
type: number
sql: ${TABLE}.id ;;
}
dimension: status {
type: string
sql: ${TABLE}.status ;;
}
dimension: user_id {
type: number
# hidden: yes
sql: ${TABLE}.user_id ;;
}
dimension_group: created {
type: time
timeframes: [
raw,
time,
date,
week,
month,
quarter,
year
]
sql: ${TABLE}.created_at ;;
}
measure: count {
type: count
drill_fields: [id, users.id, users.first_name, users.last_name, order_items.count]
}
}
La définition de ces champs dans la vue orders
présente les champs Created Date (Date de création), ID, Status (État), User ID (ID utilisateur) et Count (Nombre) dans le sélecteur de champs pour l'exploration Orders (Commandes).
Les utilisateurs ayant accès à l'exploration Orders peuvent interroger l'exploration Orders en sélectionnant et en filtrant ces champs.
En plus des dimensions et des mesures, vous pouvez également créer plusieurs dimensions temporelles à la fois à l'aide de groupes de dimensions ou spécifier un filtre pour vos utilisateurs avec des champs de filtrage. Consultez la page de documentation Paramètres de vue pour en savoir plus sur les paramètres LookML dans les fichiers de vue, ainsi que la page de documentation Paramètres de champ pour en savoir plus sur les paramètres LookML utilisés pour définir des dimensions, des mesures, des groupes de dimensions et des champs de filtre dans LookML.
Fichiers du tableau de bord
Looker prend en charge deux types de tableaux de bord:
- Des tableaux de bord définis par l'utilisateur, qui peuvent être créés par des utilisateurs non-développeurs sans utiliser LookML. Pour en savoir plus, consultez la page de documentation Créer des tableaux de bord définis par l'utilisateur.
- Les tableaux de bord LookML, stockés sous forme de fichiers de contrôle des versions associés au projet
Si votre projet contient des tableaux de bord LookML, ils seront définis dans des fichiers de tableau de bord dédiés dans l'IDE, avec l'extension .dashboard.lookml
.
Pour plus d'informations sur les tableaux de bord LookML, consultez la page de documentation Créer des tableaux de bord LookML.
Documents
Les fichiers de documents Looker vous permettent de rédiger de la documentation ou d'autres notes sur votre modèle de données Looker à l'aide du format Markdown sur GitHub. Cela peut aider vos utilisateurs à se familiariser avec la façon dont votre entreprise utilise Looker.
Consultez la page de documentation Gérer les fichiers et dossiers LookML pour savoir comment créer des fichiers de projet LookML, y compris des fichiers de document.
Afficher le document en dehors de l'IDE
Pour afficher un document en dehors de l'IDE, ce que vous devrez faire pour bénéficier des fonctionnalités de navigation décrites sur cette page, sélectionnez l'option Afficher le document dans le menu Voir les actions sur le fichier du fichier:
Vous pouvez communiquer l'URL de la page obtenue aux autres utilisateurs afin qu'ils n'aient pas besoin de naviguer dans la section des développeurs de Looker pour y accéder.
Ajouter une structure de navigation à votre document
Vous pouvez ajouter une barre latérale aux documents afin que les utilisateurs puissent facilement voir la structure des informations et naviguer entre les documents.
Pour ajouter une barre de navigation latérale à un document, créez une section de navigation en commençant par la première ligne du document. Marquez le début et la fin de votre section de navigation avec trois tirets (---
).
Vous pouvez utiliser les paramètres suivants dans la section de navigation:
navigation
Vous pouvez utiliser navigation: true
dans un fichier de document pour ajouter la barre latérale de navigation à ce document. Par exemple, vous pouvez ajouter le code suivant en haut d'un fichier Markdown:
---
navigation: true
---
Ce code ajoute au document une barre latérale de navigation contenant des liens vers tous les documents du projet. Si vous n'incluez que navigation: true
dans un document, la barre latérale de ce document liste tous les documents du projet par ordre alphabétique et par nom de fichier.
Vous constaterez peut-être également que l'organisation par nom de fichier alphabétique n'est pas idéale ou que vous ne souhaitez pas voir certains documents dans le panneau de navigation:
Dans cet exemple, vous pouvez lister les documents Document 1, Document 2, Document 3 et Document 4 par ordre numérique plutôt que par ordre alphabétique, et masquer le document Ne pas afficher dans la barre de navigation latérale.
Pour modifier l'ordre des documents dans la barre latérale de navigation ou pour afficher uniquement un sous-ensemble de vos documents dans la barre latérale, vous pouvez utiliser le format suivant:
---
navigation:
- document_one
- document_two
- document_three
- document_four
---
Désormais, l'interface de navigation n'affiche que les fichiers de document que vous souhaitez afficher, dans un ordre plus logique:
title
Par défaut, la barre latérale affiche l'en-tête du document (si celui-ci commence par un titre) ou le nom du document si le fichier ne contient pas d'en-tête. Vous pouvez ajouter un paramètre title
en haut d'un document pour modifier son affichage dans les barres de navigation latérales:
---
title: New Title for Users
---
Ce titre sera utilisé comme texte du lien dans les barres latérales de navigation de tous les documents, sauf si vous spécifiez un label
différent dans la section de navigation d'un document.
label
Si vous souhaitez modifier la façon dont un document est répertorié dans la barre latérale de navigation, vous pouvez utiliser les paramètres document
et label
comme suit:
---
navigation:
- document_one
- document: document_two
label: Customized Label for Document Two
- document_three
- document_four
---
La valeur label
définit la manière dont un document s'affiche dans la barre de navigation latérale du document, même si le document auquel il fait référence possède son propre paramètre title
.
L'exemple précédent se présente comme suit dans la barre latérale du document:
section
Si vous souhaitez diviser la barre latérale de navigation en sections, vous pouvez utiliser le paramètre section
comme suit:
---
navigation:
- document_one
- document_two
- section: My Section Name
- document_three
- document_four
---
Dans cet exemple, le paramètre section
ajoute un saut de section et l'en-tête de texte My Section Name (Nom de la section) dans la barre latérale.
L'en-tête de texte n'est pas un lien lui-même. Il ne fait référence à aucun de vos fichiers de document.
Fichiers de données
Les fichiers de données sont des fichiers JSON avec l'extension .json
, .topojson
ou .geojson
.
Le paramètre map_layer
vous permet d'utiliser un fichier JSON comme carte personnalisée, que vous pouvez ensuite utiliser pour tracer vos données dans Looker.
Ensuite, utilisez le paramètre map_layer_name avec une dimension pour associer une valeur de données (par exemple, "Paris") à une zone géographique sur votre carte personnalisée.
Vous pouvez modifier un fichier JSON dans l'IDE LookML, puis sélectionner Save (Enregistrer).
Pour le débogage, vous pouvez choisir Afficher le fichier brut en sélectionnant le menu Voir les actions sur le fichier à côté du nom du fichier pour afficher le fichier au format brut. Si vous disposez de l'extension appropriée pour afficher JSON dans votre navigateur, vous aurez également la possibilité d'afficher le fichier au format Analysé.
Consultez la page de documentation Gérer les fichiers et dossiers LookML pour savoir comment importer un fichier JSON dans un projet LookML.
Fichiers manifestes d'un projet
Votre projet peut contenir un fichier manifeste de projet, utilisé pour les tâches suivantes:
- Spécifier d'autres projets à importer dans le projet actuel
- Spécifier des paramètres de localisation de modèle
- Définir des constantes LookML
- Ajouter une extension à votre projet
- Ajouter une visualisation personnalisée à votre projet
Chaque projet ne peut contenir qu'un seul fichier manifeste. Il doit être nommé manifest.lkml
et situé au niveau racine de la structure de répertoires de votre projet ainsi que dans votre dépôt Git.
Consultez la page de documentation Gérer les fichiers et dossiers LookML pour savoir comment créer des fichiers de projet LookML, y compris des fichiers manifestes.
Fichiers de verrouillage du fichier manifeste
Les fichiers de verrouillage du fichier manifeste sont créés automatiquement lorsqu'une dépendance distante est ajoutée au fichier manifeste du projet. Looker utilise le fichier de verrouillage du fichier manifeste pour suivre la version des projets distants qui y sont spécifiés. Le fichier de verrouillage du fichier manifeste est répertorié dans le panneau de l'explorateur de fichiers de l'IDE Looker sous le nom manifest_lock.lkml
.
Les développeurs Looker n'ont pas besoin de créer ni de modifier un fichier de verrouillage du fichier manifeste, car les fichiers de verrouillage sont gérés automatiquement par Looker.
Pour en savoir plus, consultez la page de documentation Importer des fichiers à partir d'autres projets.
Fichiers de chaînes de paramètres régionaux
Si vous localisez votre modèle de données, vous devez créer des fichiers de chaînes de paramètres régionaux pour chacun d'eux, y compris vos paramètres régionaux par défaut (souvent l'anglais des États-Unis).
Les fichiers de chaînes de paramètres régionaux répertorient des paires clé/valeur pour chaque libellé et description que vous localisez dans votre modèle. Le fichier de chaînes pour chaque langue doit fournir la traduction correspondante pour chaque libellé ou description. Pour en savoir plus sur la création de fichiers de chaînes de paramètres régionaux, consultez la page de documentation Localiser votre modèle LookML.
Consultez la page de documentation Gérer les fichiers et dossiers LookML pour savoir comment créer des fichiers de projet LookML, y compris des fichiers de chaînes de paramètres régionaux.
Explorer des fichiers
Une exploration est une vue que les utilisateurs peuvent interroger. Une exploration est le point de départ d'une requête ou, en termes SQL, de l'FROM
dans une instruction SQL. Consultez la page de documentation Afficher et interagir avec des explorations dans Looker pour en savoir plus sur la manière dont les utilisateurs interagissent avec les explorations pour interroger vos données.
Les explorations sont généralement définies dans un fichier de modèle. Toutefois, vous aurez parfois besoin d'un fichier d'exploration distinct pour une table dérivée, ou pour étendre ou affiner une exploration sur plusieurs modèles.
Consultez la page de documentation Gérer les fichiers et dossiers LookML pour savoir comment créer des fichiers de projet LookML, y compris des fichiers d'exploration.
Fichiers de test de données
Votre projet peut contenir des fichiers de test de données pour vérifier la logique de votre modèle LookML. Les tests de données peuvent être contenus dans des fichiers de modèle ou des fichiers de vue, mais si vos développeurs souhaitent utiliser les mêmes tests de données sur plusieurs modèles différents, il peut être utile de conserver les tests de données dans leur propre fichier dédié.
Consultez la page de documentation Gérer les fichiers et dossiers LookML pour savoir comment créer des fichiers de projet LookML, y compris des fichiers de test de données.
Fichiers d'amélioration
Votre projet peut contenir des fichiers utilisés pour les affinages de LookML. Les améliorations LookML vous permettent d'adapter une vue ou une exploration existante sans modifier le fichier LookML qui la contient. Les perfectionnements LookML peuvent être contenus dans des fichiers de modèle, de vue ou d'exploration, ou dans leur propre fichier dédié.
Consultez la page de documentation Gérer les fichiers et dossiers LookML pour savoir comment créer des fichiers de projet LookML, y compris des fichiers de perfectionnement.
Autres fichiers
De nombreux éléments LookML peuvent être hébergés dans différents fichiers de votre projet ou dans leurs propres fichiers dédiés. Par exemple, les tests de données peuvent être hébergés dans des fichiers de modèle, des fichiers de vue ou leurs propres fichiers .lkml
dédiés.