Un projet est un ensemble de fichiers LookML qui décrit les relations entre vos tables de base de données et indique comment Looker doit les interpréter. Pour en savoir plus sur les projets, consultez les pages de documentation sur les projets et les modèles de développement LookML et les termes et concepts LookML. Pour savoir comment accéder aux projets existants et les modifier, consultez la page de documentation Accéder aux informations des projets et les modifier.
Un projet LookML peut contenir plusieurs fichiers de modèle. Toutefois, si vous souhaitez spécifier des autorisations pour les utilisateurs concernant l'affichage et la modification de LookML pour un fichier de modèle spécifique, vous pouvez créer un projet. Bien que la plupart des autorisations dans Looker s'appliquent au niveau du modèle, certaines s'appliquent au niveau du projet, y compris see_lookml, qui vous permet d'afficher LookML pour un projet, et develop, qui vous permet de modifier LookML. Si vous souhaitez autoriser les utilisateurs à accéder à un modèle, mais pas à un autre, il est judicieux de créer un projet distinct contenant le modèle dont vous n'avez pas besoin.
Créer un projet
Cliquez sur Develop (Développer) dans la barre de menu et vérifiez que vous êtes bien en Mode développeur.
Sélectionnez Projets dans le menu Développer:
Sur la page Projets LookML, cliquez sur Nouveau projet LookML pour sélectionner les options de votre projet:
Looker peut créer un projet de plusieurs manières. La procédure à suivre dépend de l'option Point de départ que vous choisissez. Les sections suivantes décrivent le fonctionnement de ces points de départ:
- Générer automatiquement un modèle à partir de votre base de données
- Cloner un dépôt Git public
- Créer un projet vide
Si vous êtes un administrateur Looker et que vous souhaitez renommer votre projet après l'avoir créé, utilisez la page Paramètres du projet (consultez la page de documentation Accéder aux informations du projet et les modifier).
Générer automatiquement un modèle à partir de votre base de données
Si vous sélectionnez Générer un modèle à partir d'un schéma de base de données comme point de départ, le générateur LookML crée automatiquement votre modèle et affiche les fichiers du projet en fonction des tables de votre base de données. Pour en savoir plus, consultez la page Générer un modèle.
Avec cette option, Looker demande le nom de la connexion pour pouvoir générer automatiquement LookML en fonction de votre base de données. Vous pourrez toutefois ajouter d'autres connexions ultérieurement.
Cloner un dépôt Git public
Si vous sélectionnez Clone Public Git Repository (Cloner le dépôt Git public), Looker copie les fichiers d'un dépôt Git public dans votre nouveau projet LookML.
Les projets Looker clonés à partir de dépôts Git publics sont en lecture seule. Toutefois, vous pouvez importer le projet en lecture seule dans un autre de vos projets Looker, où vous pourrez ensuite modifier les fichiers. Vous pouvez également utiliser les fichiers du dépôt cloné comme point de départ, puis utiliser le paramètre extends ou des affinements de Looker pour construire un projet à partir de là.
Pour cloner un dépôt Git public existant dans un projet Looker:
Cliquez sur Develop (Développer) dans la barre de menu et vérifiez que vous êtes bien en Mode développeur.
Si votre administrateur a activé la fonctionnalité expérimentale Navigation améliorée, l'option "Mode développement" se trouve dans le nouveau panneau de navigation amélioré à gauche.
Sélectionnez Gérer les projets LookML dans le menu Développer.
Sur la page Projets LookML, cliquez sur Nouveau projet LookML pour ouvrir la page Nouveau projet:
Sur la page Nouveau projet, spécifiez les options de votre projet:
- Attribuez un nom à votre projet.
- Dans le champ Point de départ,sélectionnez Cloner un dépôt Git public.
- Saisissez l'URL du dépôt Git public. Assurez-vous que l'URL est au format
git://github.com/example/my-repository.git.
Si vous disposez d'une URL telle quehttps://github.com/llooker/blocks_redshift_admin, vous pouvez la modifier au format correct en remplaçant"https://"git"par"git://", puis ajouter ".git"à la fin. L'URL à saisir serait alors:git://github.com/llooker/blocks_redshift_admin.git.
Cliquez sur Créer un projet. Looker extraira tous les fichiers du dépôt public dans un nouveau projet LookML et l'ouvrira dans l'IDE Looker.
Créer un projet vide
Si vous sélectionnez Projet vide comme point de départ, Looker crée un projet vide pour que vous puissiez créer vos fichiers LookML à partir de zéro.
Pour créer un projet vide:
Cliquez sur Develop (Développer) dans la barre de menu et vérifiez que vous êtes bien en Mode développeur.
Si votre administrateur a activé la fonctionnalité expérimentale Navigation améliorée, l'option "Mode développement" se trouve dans le nouveau panneau de navigation amélioré à gauche.
Sélectionnez Gérer les projets LookML dans le menu Développer.
Sur la page Projets LookML, cliquez sur Nouveau projet LookML pour ouvrir la page Nouveau projet:
Sur la page Nouveau projet, spécifiez les options de votre projet:
- Attribuez un nom à votre projet.
- Dans le champ Point de départ,sélectionnez Projet vide.
Cliquez sur Créer un projet. Looker crée le projet et l'ouvre dans l'IDE Looker.
Une fois que votre projet est vide, vous pouvez créer des fichiers de modèle et de vue. Vous pouvez ensuite connecter votre projet à Git pour enregistrer les modifications apportées à vos fichiers LookML et gérer les versions de vos fichiers.
Configurer un modèle
Cliquez sur le bouton Configurer un nouveau modèle en haut de la page Projets LookML pour ajouter une configuration à un modèle existant ou planifié.
La configuration d'un modèle pour un projet qui n'existe pas encore est utile si les développeurs ne disposent pas de l'autorisation manage_models, comme décrit sur la page de documentation Générer un modèle. Si vous le configurez, les développeurs pourront exécuter des requêtes dès qu'ils généreront ou créeront le fichier de modèle. Pour en savoir plus sur les projets n'ayant qu'une configuration, consultez la page de documentation Accéder aux informations sur le projet et les modifier.
Vous pouvez également spécifier les connexions de base de données pouvant être utilisées par le modèle, ou spécifier que le modèle est autorisé à utiliser toutes les connexions actuelles ou futures. Les développeurs Looker utilisent le paramètre connection de LookML pour spécifier dans le fichier de modèle la connexion que le modèle doit utiliser. Si un développeur spécifie une connexion que vous n'avez pas autorisée dans la configuration du modèle, les requêtes sur ce modèle ne seront pas exécutées.