La page Projets LookML fournit une liste de tous les projets LookML sur l'instance Looker et affiche tous les modèles de chaque projet.
Pour accéder à la page Projets LookML, procédez comme suit:
- Ouvrez le panneau Develop (Développer) en sélectionnant l'option Develop (Développer) dans le panneau de navigation.
- Dans le panneau Develop (Développer), sélectionnez Projects (Projets).
Afficher les projets existants et leurs modèles
Pour afficher la liste des projets existants, accédez à la page Projets LookML.
En mode Production, la page Projets LookML répertorie les projets générés et envoyés en production. En mode Développement, la page liste les projets que vous avez récupérés en production ou que vous avez vous-même générés en mode Développement. La page Projets LookML comprend les catégories de base suivantes:
- Section supérieure: les projets listés dans la section supérieure ont été créés et peuvent inclure des fichiers de modèle et de vue générés. Si vous êtes un administrateur Looker ou si vous disposez de l'autorisation
developpour au moins un modèle d'un projet, vous pouvez voir le projet dans le panneau Développer et en haut de la page. - Section Projets en attente: les projets listés dans la section Projets en attente sont des projets pour lesquels l'administrateur Looker a configuré les connexions autorisées pour un modèle, mais les développeurs Looker n'ont pas encore généré le projet ni la modélisation. Si vous disposez de l'autorisation
develop, vous pouvez voir ces projets. - Section Projets Marketplace: les projets répertoriés dans la section Projets Marketplace ont été créés lorsqu'une application, un bloc ou un plug-in a été installé à l'aide de Looker Marketplace.
Pour en savoir plus sur la spécification d'un nouveau projet ou d'un nouveau modèle pour un projet existant, consultez la page de documentation Créer un projet LookML.
Affichage de la liste d'un projet
La page Projets LookML affiche les éléments suivants pour chaque projet:
- Colonne Projet: nom du projet. Un ou plusieurs modèles peuvent apparaître à côté de chaque projet. Sélectionnez le nom du projet pour accéder au LookML pour ce projet.
- Colonne Modèles: ensemble des fichiers de modèle LookML pour le projet donné. Si votre environnement en mode Développement diffère de celui de production, cette liste peut passer du mode Développement au mode Production. Par exemple, vous avez peut-être créé un modèle en mode Développement que vous n'avez pas encore mis en production.
- Colonne "Problèmes de configuration" : si un modèle présente un problème, un état s'affiche pour indiquer le problème de configuration.
- Bouton Configurer: si le bouton Configurer est disponible pour un projet, vous pouvez ajouter ou modifier la configuration de modèle pour ce projet.
En cas de problème avec un modèle, un état indique le problème lié à la configuration.
| Problème | Explication |
|---|---|
| Le fichier de modèle LookML n'existe pas encore | Ce problème apparaît si un utilisateur a configuré un modèle sur cette page, mais n'a pas encore créé de fichier LookML correspondant. |
| Configuration requise pour l'utilisation | Ce problème apparaît si quelqu'un a créé un fichier de modèle LookML dans un projet existant, mais ne l'a pas encore configuré sur cette page. |
| La connexion "x" n'existe pas | Le connection déclaré dans le fichier de modèle n'existe pas (par exemple, si quelqu'un l'a mal orthographié ou ne l'a pas encore créé). |
| Le modèle "x" n'est pas autorisé à utiliser la connexion "y" | Le connection déclaré dans le fichier de modèle n'est pas autorisé, conformément à la configuration de cette page. |
| Un modèle nommé "x" est déjà configuré dans le projet "y" | Les noms de modèle doivent être uniques au sein de votre instance Looker, même s'ils se trouvent dans des projets différents. |
Afficher la fiche d'un projet Marketplace
La section Projets Marketplace de la page Projets LookML répertorie les projets créés lors de l'installation d'une application, d'un bloc ou d'un plug-in Marketplace. La fiche de chaque projet Marketplace comprend les éléments suivants:
- Liste: lien vers la fiche de l'application, du bloc ou du plug-in dans Looker Marketplace.
- Projet: nom du projet. Vous pouvez cliquer sur le nom du projet pour afficher ou modifier son code LookML.
- Bouton Afficher LookML ou Modifier LookML: vous pouvez accéder à un projet Marketplace en sélectionnant le bouton Afficher LookML pour le projet principal en lecture seule d'un bloc Marketplace ou Modifier LookML pour son projet de configuration. Ce dernier peut être personnalisé. Pour en savoir plus sur la personnalisation des blocs Marketplace, consultez la page de documentation Personnaliser les blocs de Marketplace Looker.
- Modèles: ensemble des fichiers de modèle LookML pour le projet donné.
- Bouton Configurer: si le bouton Configurer est disponible à côté de la liste du projet, vous pouvez ajouter ou modifier la configuration de modèle du projet.
Afficher la fiche d'un projet en attente
La section Projets en attente contient des modèles configurés avec un nom de projet, mais qui n'ont pas encore été générés. Ainsi, la section Projets en attente contient des projets et des modèles qui sont uniquement configurés et qui ne comportent pas encore de code LookML.
Configurer des modèles avant la création du projet est utile si certains de vos développeurs n'ont reçu ni l'autorisation manage_models, ni l'autorisation manage_project_models. Comme le modèle a déjà été configuré, ces développeurs peuvent exécuter des requêtes dès qu'ils créent le projet et ce modèle. Une fois le projet généré, sa liste est déplacée dans la section supérieure de la page Projets LookML.
La section Projets en attente comprend les éléments suivants:
- Colonne Projet: cette section répertorie les projets configurés, mais pas encore générés. Le nom de projet indiqué dans ce champ correspond au nom attendu du projet. Sélectionnez le nom du projet pour afficher la page Nouveau projet, qui vous permet de générer ce projet. Vous devez être en mode Développement pour accéder à la page Nouveau projet.
- Colonne Modèles: nom du modèle spécifié lors de la création de la configuration du modèle.
- Colonne "Connexions autorisées" : la colonne à droite du nom du modèle affiche les connexions qui étaient autorisées pour ce modèle lorsque sa configuration a été créée.
- Bouton Configure (Configurer) : ce bouton Configuration vous permet de modifier le nom du projet et les connexions autorisées pour ce modèle.
- Bouton Add LookML (Ajouter LookML) : le bouton Add LookML (Ajouter LookML) ouvre la page New Project (Nouveau projet) de ce projet, ce qui vous permet d'utiliser le générateur LookML pour générer automatiquement LookML en fonction d'un ensemble de tables de votre base de données.
Ajouter et modifier des configurations
Si le bouton Configurer est disponible à côté de la liste du projet, vous pouvez ajouter ou modifier la configuration du modèle du projet.
Si le modèle ne possède pas de configuration, lorsque vous cliquez sur Configurer, Looker affiche la fenêtre Configurer un modèle. Dans la fenêtre Configure a Model (Configurer un modèle), vous pouvez spécifier le nom du modèle, le nom du projet et les connexions disponibles pour le modèle.
La liste des connexions n'inclut que les connexions pouvant être utilisées avec le projet du modèle. Les connexions configurées pour être utilisées dans tous les projets portent le libellé (Instance wide).
Si le modèle comporte une configuration, lorsque vous cliquez sur Configurer, Looker affiche la fenêtre Modifier la configuration du modèle. Dans la fenêtre Modifier la configuration du modèle, vous pouvez modifier les connexions disponibles pour le modèle.
Lorsque vous modifiez la configuration d'un modèle, vous pouvez afficher son nom, mais pas le renommer. Les modèles sont nommés d'après le nom de fichier que vous utilisez lorsque vous modifiez les fichiers de modèle dans l'IDE Looker.
Dans le champ Project (Projet), vous pouvez spécifier que le modèle doit être associé à un autre projet. Par exemple, si vous avez créé un projet contenant un modèle portant le même nom, vous pouvez effectuer une transition de la configuration de modèle pour l'associer au modèle du nouveau projet.
Dans le champ Connexions autorisées, vous pouvez limiter le modèle à une liste de connexions spécifiques ou l'autoriser à utiliser n'importe quelle connexion (toutes les connexions actuelles et futures).
Renommer un projet
Lorsqu'un administrateur Looker crée un projet LookML, il fournit un nom de projet. Le nom du projet doit être considéré comme un ID permanent pour le projet, car Looker l'utilise de différentes manières:
- Pour identifier le projet pour les appels d'API avec le paramètre
project_id. - Identifier le projet dans la base de données interne de l'instance Looker.
- Pour identifier le projet en vue de l'importation de projets en local, procédez comme suit :
- Pour afficher le projet sur la page Projets LookML, procédez comme suit :
- Afficher le projet dans la section Développer du panneau de navigation Looker
- Dans l'URL des fichiers du projet. Par exemple, sur une instance Looker avec l'URL
example.looker.com, le fichier manifeste du projet nomméecommerceest disponible à l'adresse suivante:https://example.looker.com/projects/ecommerce/files/manifest.lkml.
Si vous disposez de l'autorisation Looker manage_models, vous pouvez modifier le nom d'un projet LookML depuis la page Paramètres du projet. Les développeurs Looker qui ne sont pas administrateurs peuvent consulter la page Paramètres du projet, mais ne peuvent pas modifier ses options.
Pour renommer un projet, procédez comme suit:
- Vérifiez que le mode Développement est activé.
- Accédez à votre projet dans l'IDE Looker.
- Dans votre projet, cliquez sur Settings (Paramètres) dans la barre de navigation de l'IDE pour ouvrir le panneau des paramètres du projet.
- Sélectionnez Configuration dans le panneau des paramètres du projet.
- Utilisez le champ Nom sous Configuration du projet pour modifier le nom de votre projet.
- Sur la page Configuration du projet, cliquez sur Enregistrer la configuration du projet pour enregistrer le nom du nouveau projet.
Supprimer un projet
Si vous êtes un administrateur Looker, vous pouvez supprimer un projet existant depuis la page Paramètres du projet. Pour afficher la page Paramètres du projet, ouvrez votre projet, puis cliquez sur Paramètres dans la barre de navigation de l'IDE.
Un projet supprimé n'apparaît plus dans la section Projets de la page Projets LookML, mais apparaît toujours dans la section Projets configurés.
Pour supprimer la configuration du projet, ce qui supprime complètement le projet de votre environnement de développement:
- Accédez à votre projet dans l'IDE Looker.
- Dans votre projet, cliquez sur Settings (Paramètres) dans la barre de navigation de l'IDE pour ouvrir le panneau Project Settings (Paramètres du projet).
- Dans le panneau des paramètres du projet, sélectionnez Configuration pour afficher la configuration du projet.
- Sous Configuration du projet, sélectionnez Supprimer le projet.
- Dans la fenêtre Supprimer le projet, vérifiez les avertissements et les modifications non synchronisées qui seront perdus si le projet est supprimé.
- Si vous êtes certain que le projet doit être supprimé, saisissez son nom dans le champ. Pour annuler l'opération et revenir à votre projet, utilisez le bouton Retour de votre navigateur.
- Cliquez sur le bouton Supprimer définitivement <nom du projet>.