Création d'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 définir des autorisations permettant aux utilisateurs d'afficher et de modifier le 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 donner aux utilisateurs l'accès à un modèle, mais pas à un autre, nous vous recommandons de créer un projet distinct contenant le modèle auquel vous ne voulez 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 Projects (Projets) dans la section Develop (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 en fonction de 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. De plus, vous pouvez utiliser les fichiers du dépôt cloné comme point de départ, puis utiliser le paramètre Looker extends ou des affinements pour créer un projet à partir de là.

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 différentes manières:

      • 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 du projet. Par exemple, sur une instance Looker avec l'URL example.looker.com, le fichier manifeste du projet nommé ecommerce est disponible à l'adresse 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 disposez d'une URL telle que https://github.com/llooker/blocks_redshift_admin, vous pouvez la modifier au bon format. Pour ce faire, remplacez "https://" par "git://", puis ajoutez ".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 l'ouvre 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 vide:

  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 différentes manières:

      • 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 du projet. Par exemple, sur une instance Looker avec l'URL example.looker.com, le fichier manifeste du projet nommé ecommerce est disponible à l'adresse 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 model 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 à 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 aux informations d'un 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 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.