Générer un modèle

Cette page explique comment créer un projet et générer automatiquement un modèle de base à partir de votre base de données.

Il existe d'autres options pour créer vos fichiers de projet : vous pouvez créer un projet vide et créer manuellement son modèle, ou cloner un dépôt Git public existant. Pour en savoir plus, consultez la page de documentation Créer un projet LookML.

Générer automatiquement un modèle à partir de votre base de données

Vous pouvez générer automatiquement un modèle à partir de votre base de données dans la section Développer de Looker ou à l'aide du bouton Créer dans le panneau de navigation de gauche.

Générer un modèle depuis la section Develop (Développer)

  1. Cliquez sur Develop (Développer) dans le panneau de navigation de gauche et 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:

    • La page Projets LookML vous permet d'afficher tous vos projets ainsi que leurs modèles respectifs. Cette page vous permet de créer, d'afficher et de configurer vos projets.

  4. Dans la boîte de dialogue 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 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 :
      • Pour 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 Générer un modèle à partir du schéma de base de données.

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

    • 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.

    • 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.

    • Ignorer les préfixes: pour exclure les préfixes de table des noms de fichiers de vos vues, 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.

  5. Cliquez sur Créer un projet.

    • 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, utilisez le panneau Explorer pour sélectionner le nom d'une exploration.

Pour renommer votre projet après l'avoir créé, consultez la section Renommer un projet de la page de documentation Accéder et modifier les informations sur un projet.

Vous pouvez créer manuellement d'autres modèles pour votre projet, comme décrit sur la page de documentation Comprendre les fichiers de modèle et de vue, les configurer pour une utilisation en production comme indiqué dans la section Cas de configuration des modèles de cette page, et trouver des instructions supplémentaires sur la page de documentation Créer un projet LookML.

Une fois les fichiers de votre modèle générés ou créés manuellement, consultez la page Configurer et tester une connexion Git pour en savoir plus sur la connexion de votre projet Looker à Git. Vous pouvez enregistrer les modifications apportées à vos fichiers LookML et gérer leurs versions.

Générer un modèle à l'aide du bouton Créer

Pour créer un projet et générer un modèle à l'aide du bouton Créer, procédez comme suit :

  1. Cliquez sur le bouton Créer dans le panneau de navigation de gauche.
  2. Sélectionnez l'option de menu Modèle LookML.
  3. Vérifiez que vous êtes en mode Développement.
  4. Une fois en mode Développement, la page Créer un projet s'ouvre.
  5. Si vous souhaitez sélectionner des vues de base pour les explorations, ou personnaliser d'autres options avancées comme ignorer les préfixes de table dans les noms de fichiers de vue générés, importer les métadonnées de description de champ depuis la base de données, déterminer la création du fichier de modèle et sélectionner les fichiers README générés automatiquement, activez l'option Création de projet avancée.
  6. Sélectionnez une connexion de base de données dans le menu déroulant Sélectionner une connexion à la base de données. Si vous avez accès à des projets qui utilisent déjà la connexion, ils s'afficheront une fois la connexion sélectionnée. Vous pouvez choisir d'utiliser un projet disponible et d'y ajouter un modèle ou de créer un projet LookML. Si vous choisissez d'ajouter le modèle à un projet, la section Créer un modèle s'affiche comme première étape sur la page Créer un projet, où vous pouvez nommer le modèle. Une fois que vous avez effectué vos sélections, cliquez sur Suivant.
  7. Dans la section Sélectionner des données, sélectionnez les schémas, les tables et les champs à utiliser dans le modèle. Des vues seront créées à partir des tables. Une fois que vous avez effectué vos sélections, cliquez sur Suivant.
  8. Sélectionnez une clé primaire pour chaque table. Looker peut ainsi mieux joindre vos tables. Une fois que vous avez effectué vos sélections, cliquez sur Suivant.
  9. Si vous avez activé l'option Création avancée de projet, sélectionnez les vues de base pour les explorations. Sélectionner chaque vue désirée comme vue de base pour un Explore. Pour chaque vue sélectionnée, le système va joindre automatiquement autant d'autres vues que possible. Seules les vues associées à une clé primaire à l'étape précédente peuvent être utilisées dans une jointure. Une fois vos sélections effectuées, cliquez sur Suivant.
  10. Si vous avez activé l'option Advanced Project Creation (Création de projet avancée), effectuez les sélections suivantes dans la section Advanced Options (Options avancées) :
    • Ignorer les préfixes : pour ignorer les préfixes de table dans les noms des fichiers de vue générés, saisissez les préfixes de la base de données dans une liste de ce champ, en les séparant par une virgule. Ce champ est sensible à la casse. Vous pouvez indiquer plusieurs préfixes, séparés par une virgule. 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.
    • Descriptions des champs : cochez la case Importer les métadonnées de description des champs pour utiliser toutes les descriptions de champ disponibles dans la base de données en tant que descriptions LookML pour les dimensions générées.
    • Gestion des fichiers de modèle : choisissez si vous souhaitez ou non créer un fichier de modèle. Si vous choisissez de créer un fichier de modèle, saisissez le nom que vous souhaitez lui attribuer dans le champ Nom du modèle.
    • Guide de démarrage : cochez la case Generate a Readme file that describes how to use the output (Générer un fichier README décrivant comment utiliser la sortie) pour générer un fichier README décrivant comment utiliser le projet.
  11. Cliquez sur Générer le modèle pour générer les fichiers du projet. Une fois les fichiers générés, Looker vous redirige vers l'IDE Looker.

Génération de code LookML améliorée

Si votre administrateur Looker a activé la fonctionnalité de laboratoire Amélioration de la génération LookML, Looker ajoute des éléments supplémentaires à votre projet lorsque vous le générez à partir de votre base de données:

  • Looker ajoute un fichier README au nouveau projet. Le fichier README contient une introduction à LookML, ainsi que des liens et des ressources pour aider les nouveaux développeurs LookML.
  • Looker ajoute plusieurs explications de commentaires intégrées au fichier de modèle et à chaque fichier de vue.
  • Si une vue comporte au moins une dimension type: number qui ne contient pas la chaîne id dans son nom, Looker crée une mesure type: sum et une mesure type: average, toutes deux basées sur la première dimension type: number par ordre alphabétique qui ne contient pas la chaîne id dans son nom.

Lorsque vous devez configurer des modèles

Configurer un modèle est utile pour les raisons suivantes :

  • Il indique qu'un nom de modèle donné fait référence à un modèle particulier dans un projet particulier.
  • Il définit les connexions que le modèle est autorisé à utiliser.

Les administrateurs (ou les développeurs disposant de l'autorisation manage_models ou manage_project_models) n'ont pas besoin de configurer un modèle lorsqu'ils sont en mode développement. Cela permet aux développeurs LookML de travailler en mode Développement. Toutefois, si une configuration de modèle existe, toutes les requêtes sont limitées par cette configuration, même en mode Développement.

Bien qu'un développeur LookML spécifie la connexion souhaitée dans le fichier de modèle, un administrateur contrôle les connexions autorisées sur la page Projets LookML. Si un modèle spécifie l'utilisation d'une connexion non autorisée dans sa configuration, cette connexion n'est pas autorisée.

Un modèle doit avoir une configuration dans les scénarios suivants :

  • Lorsqu'un modèle est mis en production pour la première fois. Si le modèle n'est pas configuré, toutes les requêtes sur ce modèle échouent une fois qu'il est en mode Production. Lorsqu'un modèle passe du mode Développement en production pour la première fois, Looker le configure automatiquement si son nom est unique pour l'instance Looker. Toutefois, si vous disposez d'un modèle configuré portant le même nom dans un autre projet, Looker ne le configure pas automatiquement.
  • Pendant le développement. Si des développeurs n'ont pas reçu l'autorisation manage_models (qui est incluse dans le rôle admin) ni l'autorisation manage_project_models, le modèle doit être configuré avant qu'ils ne puissent exécuter des requêtes dessus. Vous pouvez configurer le modèle avant qu'il n'existe ou avant l'existence du projet. Ensuite, lorsqu'un développeur LookML crée le projet et le modèle, les connexions autorisées du modèle sont déjà configurées, et le développeur peut exécuter des requêtes.

Looker permet aux développeurs disposant de l'autorisation manage_models ou manage_project_models d'exécuter des requêtes sur un modèle non configuré en mode Développement. Pour ce faire, Looker recherche un modèle portant ce nom dans les projets. Le premier modèle trouvé avec ce nom est utilisé pour exécuter la requête.