Notez que vous consultez la documentation Looker. Pour accéder à la documentation sur Looker Studio, consultez la page https://support.google.com/looker-studio.

Cette page a été traduite par l'API Cloud Translation.

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

Cliquez sur Develop (Développer) dans la barre de menu et vérifiez que vous êtes bien en mode Développement.
Sélectionnez Projects (Projets) dans la section Develop (Développer) du panneau de navigation.
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.
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 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 Générer un modèle à partir d'un 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.
- Build Views From (Compiler les vues à partir de) : sélectionnez l'une des options suivantes:
  - All Tables (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.
- Schémas: 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.
- 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 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 Ignore Prefixes (Ignorer les préfixes), Looker crée des fichiers de vue nommés orders et users.
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 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 aux informations du projet et les 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 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é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 dont le nom ne contient pas la chaîne id, Looker crée une mesure de type: sum et une mesure 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

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

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

Il n'est pas nécessaire de configurer un modèle pour les administrateurs (ou les développeurs disposant de l'autorisation manage_models ou manage_project_models) 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 qui n'est pas autorisée dans sa configuration, la connexion n'est pas autorisée.

Un modèle doit disposer d'une configuration dans les cas 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 qui lui sont adressées é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 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 développeurs n'ont reçu ni 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 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 les requêtes correctement.

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é portant ce nom est utilisé pour exécuter la requête.