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 les fichiers de votre projet: vous pouvez créer un projet vierge et créer manuellement son modèle, ou cloner un dépôt Git public existant. Pour en savoir plus, consultez la page Créer un projet LookML.

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

  1. Cliquez sur Développer dans la barre de menu et 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 LookML Projects, 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:

    • Attribuez un nom à votre projet.
    • Pour le point de départ, sélectionnez Générer un modèle à partir d'un 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 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 de votre base de données, saisissez son nom dans le champ de texte Schémas. Vous pouvez lister plusieurs schémas, séparés par une virgule.
    • Pour omettre les préfixes de table dans les 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 les 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 d'affichage 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 remplit automatiquement les descriptions des champs avec les descriptions 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 Explorer pour sélectionner le nom d'une exploration.

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

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 d'affichage, les configurer pour les utiliser en production, comme indiqué dans la section Lorsque vous devez configurer des modèles, puis trouver des instructions supplémentaires sur la page Créer un projet LookML.

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

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

Si votre administrateur Looker a activé la fonctionnalité expérimentale Génération de 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 pour aider les nouveaux développeurs LookML.
  • Looker ajoute plusieurs explications des commentaires intégrés au fichier de modèle et à chaque fichier de vue.
  • Si une vue comporte au moins une dimension type: number dont le nom ne contient pas la chaîne id, 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 qui ne contient pas la chaîne id dans son nom.

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

Aucune configuration de modèle n'est nécessaire pour les administrateurs (ou les développeurs avec l'autorisation manage_models) lorsqu'ils sont en mode développement. Les développeurs LookML peuvent ainsi 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 de 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 une configuration de modèle utilise une connexion non autorisée dans sa configuration, la connexion n'est pas autorisée.

Un modèle doit avoir une configuration dans les cas suivants:

  • Lorsqu'un modèle passe en production pour la première fois. Si le modèle n'est pas configuré, toutes les requêtes associées échoueront une fois le modèle 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 certains de vos développeurs ne disposent pas de l'autorisation manage_models (incluse dans le rôle admin), celui-ci 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 le projet. Ensuite, lorsqu'un développeur LookML crée le projet et le modèle, les connexions autorisées à celui-ci 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 d'exécuter des requêtes sur un modèle non configuré en mode développement. Pour ce faire, Looker recherche les projets portant ce nom. Le premier modèle portant ce nom est utilisé pour exécuter la requête.