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.

D'autres options sont disponibles pour créer les fichiers de votre projet. Vous pouvez créer un projet vide et créer manuellement son modèle, ou cloner un dépôt Git public existant, consultez la page de documentation Créer un projet LookML.

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

1. Cliquez sur Develop (Développer) dans la barre de menu et vérifiez que vous êtes bien en mode Développement.

2. Sélectionnez Projects (Projets) dans la section Develop (Développer) du panneau de navigation.

   

3. Sur la page LookML Projects (Projets LookML), sélectionnez New LookML Project (Nouveau projet LookML) :

   • La page Projets LookML vous permet d'afficher tous vos projets avec 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:

   • Attribuez un nom à votre projet.
   • Dans le champ Point de départ, sélectionnez Générer un modèle à partir du schéma de base de données.
   • Dans le menu déroulant Connexion, sélectionnez le nom de votre connexion à la base de données.
   • Dans Build Views from (Créer des vues à partir de), sélectionnez une option :
     • 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 base de données.
   • Pour générer des fichiers pour un seul schéma dans votre base de données, saisissez le nom du schéma dans le champ de texte Schémas. Vous pouvez répertorier plusieurs schémas, séparés par une virgule.
   • 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 de texte Ignorer les préfixes. 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.

5. Cliquez sur Créer un projet.

   • Le générateur LookML crée un fichier de modèle pour le projet et 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 issues de vos métadonnées de colonne 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 Explore (Explorer) afin de 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 Accéder aux informations d'un projet et les modifier.

Vous pouvez créer manuellement des modèles supplémentaires pour votre projet, comme indiqué 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 Quand vous devez configurer des modèles de cette page, et obtenir des instructions supplémentaires sur la page de documentation Créer un projet LookML.

Une fois vos fichiers de modèle générés ou créés manuellement, consultez la page de documentation 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 les versions de vos fichiers.

Amélioration de la génération du code LookML

Si votre administrateur Looker a activé la fonctionnalité de laboratoire Génération de code LookML améliorée, 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 d'aide aux nouveaux développeurs LookML.
• Looker ajoute plusieurs explications de commentaires intégrés au fichier de modèle et à chaque fichier de vue.
• Si une vue comporte au moins une dimension de type: number qui ne contient pas la chaîne id dans son nom, Looker crée une mesure de type: sum et une mesure de type: average, toutes deux basées sur la première dimension alphabétique de type: number dont le nom ne contient pas la chaîne id.

Quand vous devez configurer des modèles

La configuration d'un modèle est utile pour les raisons suivantes:

• Il spécifie 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.

En mode Développement, les administrateurs (ni les développeurs disposant de l'autorisation manage_models ou manage_project_models) n'ont pas besoin de configurer un modèle. Cela permet aux développeurs LookML de travailler facilement 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 quelles connexions sont autorisées sur la page Projets LookML. Si un modèle spécifie l'utilisation d'une connexion qui n'est pas autorisée dans sa configuration, la 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 que le modèle 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 avez configuré un modèle portant le même nom dans un autre projet, Looker ne le configure pas automatiquement.
• Pendant le développement Si certains de vos développeurs n'ont pas reçu l'autorisation manage_models (incluse dans le rôle admin) ni l'autorisation manage_project_models, le modèle doit être configuré pour que ces développeurs puissent exécuter des requêtes sur ce modèle. Vous pouvez configurer le modèle avant qu'il n'existe ou avant que le projet existe. 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.

Remarque :Pour les développeurs qui ne disposent pas des autorisations manage_models ou manage_project_models, les administrateurs peuvent limiter l'accès à certaines connexions en limitant les développeurs à des ensembles de modèles particuliers et en limitant les connexions autorisées pour ces modèles.

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.