Créer un projet LookML

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 Projets et modèle de développement LookML et Termes et concepts LookML. Pour savoir comment accéder aux projets existants et les modifier, consultez la page de documentation Accéder aux informations d'un projet 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 la consultation et la modification du code LookML d'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 le code LookML d'un projet, et develop, qui vous permet de le modifier. Si vous souhaitez autoriser les utilisateurs à accéder à un modèle, mais pas à un autre, nous vous recommandons de créer un projet distinct contenant le modèle auquel vous ne souhaitez pas qu'ils aient accès.

Les utilisateurs de Looker disposant de l'autorisation manage_models peuvent créer des modèles LookML sur une instance Looker.

Créer un projet

Pour créer un projet, procédez comme suit:

  1. Vérifiez que vous êtes en mode Développement.

  2. Sélectionnez Projets dans la section Développer du panneau de navigation.

  3. Sur la page Projets LookML, sélectionnez Nouveau projet LookML pour choisir les options de votre projet.

Cette action ouvre la page Nouveau projet, où vous pouvez spécifier les paramètres de votre projet, y compris son nom et son point de départ.

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 sur la page Nouveau projet. 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

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 de documentation Générer un modèle.

Avec cette option, Looker demande le nom de la connexion pour pouvoir générer automatiquement le code LookML basé sur votre base de données. Toutefois, vous pourrez toujours ajouter d'autres connexions plus tard.

Cloner un dépôt Git public

Si vous sélectionnez Cloner un dépôt Git public comme point de départ, 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 les affinements de Looker pour créer un projet.

Pour cloner un dépôt Git public existant dans un projet Looker:

  1. Vérifiez que vous êtes en mode Développement.
  2. Sélectionnez Gérer les projets LookML dans le menu Développer.

  3. Sur la page Projets LookML, sélectionnez Nouveau projet LookML pour ouvrir la page Nouveau projet.

  4. Sur la page New Project (Nouveau projet), spécifiez les options de votre projet:

    • Nom du projet : attribuez un nom à votre projet. Choisissez soigneusement le nom du projet et considérez-le comme un ID permanent, car Looker l'utilise de la manière suivante :

      • Pour identifier le projet pour les appels d'API qui comportent 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 de projet. Par exemple, sur une instance Looker dont l'URL est example.looker.com, le fichier manifeste du projet nommé ecommerce se trouve à l'URL suivante : https://example.looker.com/projects/ecommerce/files/manifest.lkml.

    • Point de départ: sélectionnez Cloner le dépôt Git public.

    • URL du dépôt Git: 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 avez une URL telle que https://github.com/llooker/blocks_redshift_admin, vous pouvez la modifier pour utiliser le format approprié en remplaçant "https://" par "git://", puis en ajoutant ".git" à la fin. L'URL à saisir serait git://github.com/llooker/blocks_redshift_admin.git.

  5. Sélectionnez Créer un projet. Looker extrait tous les fichiers du dépôt public dans un nouveau projet LookML et ouvre le projet 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 afin que vous puissiez créer vos fichiers LookML de A à Z.

Pour créer un projet vierge :

  1. Vérifiez que vous êtes en mode Développement.
  2. Sélectionnez Gérer les projets LookML dans le menu Développer.

  3. Sur la page Projets LookML, sélectionnez Nouveau projet LookML pour ouvrir la page Nouveau projet.

  4. Sur la page New Project (Nouveau projet), spécifiez les options de votre projet:

    • Nom du projet : attribuez un nom à votre projet. Choisissez soigneusement le nom du projet et considérez-le comme un ID permanent, car Looker l'utilise de la manière suivante :

      • Pour identifier le projet pour les appels d'API qui comportent le paramètre project_id.
      • Pour 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 dont l'URL est example.looker.com, le fichier manifeste du projet nommé ecommerce se trouve à l'URL suivante : https://example.looker.com/projects/ecommerce/files/manifest.lkml.

    • Point de départ: sélectionnez Projet vide.

  5. Sélectionnez 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, puis connecter votre projet à Git pour enregistrer les modifications apportées à vos fichiers LookML et gérer leurs versions.

Configurer un modèle

Utilisez le bouton Configurer un nouveau modèle en haut de la page Projets LookML pour ajouter une configuration pour 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 n'ont pas reçu l'autorisation manage_models ou manage_project_models, comme décrit sur la page de documentation Générer un modèle. Si vous configurez le modèle pour les développeurs, ils pourront exécuter des requêtes dès qu'ils auront généré ou créé le fichier de modèle. Pour en savoir plus sur les projets ne comportant qu'une configuration, consultez la page de documentation Accéder et modifier les informations sur les projets.

Vous pouvez également spécifier les connexions de base de données pouvant être utilisées par le modèle, ou indiquer que le modèle est autorisé à utiliser n'importe quelle connexion actuelle ou future. Les développeurs Looker utilisent le paramètre LookML connection 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, aucune requête sur ce modèle ne sera exécutée.