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 LookML et modèle de développement et Termes et concepts LookML. Pour savoir comment accéder à des projets existants et les modifier, consultez la page de documentation Accéder aux informations sur les 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 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.

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 sélectionner 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. Les étapes suivies dépendent 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

Sur la page Nouveau projet, spécifiez les options suivantes pour générer automatiquement un modèle à partir d'une base de données.

  1. Nom du projet: attribuez un nom à votre projet. Les noms de projet sont sensibles à la casse et ne peuvent contenir que des caractères alphanumériques, _, . et -. Choisissez soigneusement le nom du projet et considérez-le comme un ID permanent, car Looker l'utilise comme suit:

    • Pour identifier le projet pour les appels d'API avec le paramètre project_id.
    • Pour identifier le projet dans la base de données interne de l'instance Looker.
    • Pour identifier le projet à importer localement.
    • Pour afficher le projet sur la page Projets LookML.
    • Pour 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.

  2. Point de départ: sélectionnez Générer un modèle à partir du schéma de base de données.

  3. Connexion: dans le menu déroulant, sélectionnez le nom de votre connexion à la base de données.

  4. Créer des vues à partir de: sélectionnez l'une des options suivantes:

    • Toutes les tables: le générateur LookML crée un fichier de vue pour chaque table de votre base de données.
    • Table unique: le générateur LookML crée une vue pour une table de votre base de données. Si vous choisissez cette option, saisissez le nom de la table de la base de données.

  5. Schémas: pour générer des fichiers pour un seul schéma de votre base de données, saisissez le nom du schéma dans le champ de texte Schémas. Vous pouvez lister plusieurs schémas, séparés par des virgules.

  6. Ignorer les préfixes: pour ne pas inclure les préfixes de table dans les noms de vos fichiers de vue, saisissez les préfixes de votre base de données dans le champ Ignorer les préfixes. Ce champ est sensible à la casse. Vous pouvez lister plusieurs préfixes, séparés par des virgules. Par exemple, vos tables sont intitulées dwh_orders et DBS_users. Si vous saisissez dwh, DBS dans le champ de texte Ignorer les préfixes, Looker crée des fichiers de vue nommés orders et users.

Enfin, cliquez sur Create Project (Créer un projet) pour créer un projet contenant le modèle généré.

  • Le générateur LookML crée un fichier de modèle pour le projet, ainsi qu'un fichier de vue pour chaque table de la base de données (sauf indication contraire). Looker ouvre ensuite le nouveau projet dans l'IDE Looker.
  • Le générateur LookML crée des dossiers IDE pour vos fichiers de vue et de modèle. Si votre base de données comporte plusieurs schémas, le générateur LookML crée un dossier pour les schémas.

Pour les connexions BigQuery, si vous générez un projet LookML à partir de votre base de données, Looker renseigne automatiquement les descriptions des champs avec les descriptions des métadonnées de vos colonnes BigQuery, le cas échéant.

Le générateur crée également une exploration pour chaque table de base de données. Pour commencer à interroger vos données, sélectionnez le nom d'une exploration dans le panneau Explorer.

Cloner un dépôt Git public

Si vous sélectionnez Cloner un dépôt Git public comme point de départ, Looker copiera 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 à partir de là.

Sur la page Nouveau projet, spécifiez les options suivantes pour cloner un dépôt Git public existant dans un projet Looker:

  1. Nom du projet: attribuez un nom à votre projet. Les noms de projet sont sensibles à la casse et ne doivent pas contenir d'espaces ni certains caractères spéciaux. 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 avec le paramètre project_id.
    • Pour identifier le projet dans la base de données interne de l'instance Looker.
    • Pour identifier le projet à importer localement.
    • Pour afficher le projet sur la page Projets LookML.
    • Pour 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.

  2. Point de départ: sélectionnez Cloner un dépôt Git public.

  3. 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 pour qu'elle utilise le format approprié en remplaçant "https://" par "git://", puis en ajoutant ".git" à la fin. L'URL que vous devez saisir est git://github.com/llooker/blocks_redshift_admin.git.

Pour finir, cliquez sur 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 Blank Project (Projet vide) comme point de départ, Looker crée un projet vide afin que vous puissiez créer vos fichiers LookML à partir de zéro.

Sur la page New Project (Nouveau projet), spécifiez les options suivantes pour créer un projet vide:

  1. Nom du projet: attribuez un nom à votre projet. Les noms de projet sont sensibles à la casse et ne doivent pas contenir d'espaces ni de certains caractères spéciaux. 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 avec le paramètre project_id.
    • Pour identifier le projet dans la base de données interne de l'instance Looker.
    • Pour identifier le projet à importer localement.
    • Pour afficher le projet sur la page Projets LookML.
    • Pour 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.

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

Pour finir, cliquez sur Créer un projet. Looker crée le projet et l'ouvre dans l'IDE Looker.

Étapes suivantes

Une fois le projet créé, vous pouvez: