Générer un modèle LookML

Cette page de documentation décrit la procédure à suivre pour générer automatiquement un modèle LookML de base à partir de votre connexion de base de données à l'aide de la page Créer un modèle. La page Créer un modèle vous permet également de créer un projet qui hébergera votre modèle.

Il existe d'autres options pour créer des fichiers de modèle:

  • Vous pouvez créer manuellement des fichiers de modèle et d'autres fichiers de projet à partir de l'IDE.

  • Vous pouvez utiliser l'ancienne méthode pour créer des projets et générer des modèles en cliquant sur l'une des options suivantes, qui vous redirigent vers l'ancienne page New Project (Nouveau projet) :

    • le lien dans la bannière en haut de la page Créer un modèle ;
    • le bouton Ajouter LookML dans la section Projets en attente de la page Projets

    Une fois sur la page Nouveau projet, suivez les étapes décrites dans la documentation Créer un projet LookML.

Accéder à la page Créer un modèle

Accédez à la page Créer un modèle de deux manières:

Pour accéder à la page Créer un modèle, vous devez être en mode développement.

Pour accéder à la page Créer un modèle, vous devez être administrateur Looker ou disposer de l'autorisation develop.

Dans la section Develop (Développer)

Pour accéder à la page Créer un modèle depuis la section Développer, procédez comme suit :

  1. Cliquez sur Développer dans le panneau de navigation de gauche.

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

  3. Cette sélection ouvre la page Projets LookML. La page Projets LookML vous permet d'afficher tous les projets auxquels vous avez accès, ainsi que leurs modèles respectifs. Sur la page Projets LookML, sélectionnez le bouton Nouveau modèle pour ouvrir la page Créer un modèle.

Depuis le bouton Créer

Pour accéder à la page Créer un modèle à partir du bouton Créer, procédez comme suit :

  1. Dans le menu de navigation principal, cliquez sur le bouton Créer.
  2. Sélectionnez Modèle LookML dans le menu déroulant. La page Créer un modèle s'ouvre.

Générer un modèle

La page Créer un modèle est divisée en sections. Pour générer un modèle, procédez comme indiqué dans les sections suivantes. Après chaque section, cliquez sur Suivant pour enregistrer vos informations et passer à la section suivante.

  1. Sélectionner la connexion à une base de données:

    • Sélectionner une connexion à une base de données: sélectionnez une connexion à une base de données dans le menu déroulant. Vous pouvez également sélectionner l'option Créer une connexion dans le menu déroulant. Vous êtes alors redirigé vers la page Connecter votre base de données à Looker, où vous pouvez créer une connexion.

    • Si vous avez accès à des projets qui utilisent déjà la connexion, ils s'affichent une fois la connexion sélectionnée. Vous pouvez choisir d'ajouter votre nouveau modèle à un projet existant disponible ou de créer un projet LookML pour votre modèle.

    • Nom du projet LookML: si vous souhaitez créer un projet LookML pour le modèle, saisissez un nom de projet dans ce champ. Les noms de projet sont sensibles à la casse et ne peuvent contenir que des caractères alphanumériques, _, . et -. Choisissez le nom du projet avec soin et considérez-le comme un identifiant permanent. Les nouveaux projets sont configurés à l'aide d'un dépôt Git nu.

    • Cochez la case Générer un fichier README contenant des informations supplémentaires sur l'utilisation de LookML si vous souhaitez que 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.

    • Cliquez sur le bouton Suivant pour enregistrer vos informations et passer à la section suivante.

  2. Sélectionnez "Tables":

    • Si vous utilisez une connexion BigQuery, sélectionnez le Google Cloud projet dans lequel se trouve l'ensemble de données dans le menu déroulant Sélectionner un projet GCP ou recherchez le projet dans le champ Rechercher le nom du projet. Par défaut, le projet de stockage Google Cloud s'affiche dans le menu déroulant s'il existe. S'il n'existe pas, le projet de facturation Google Cloud s'affiche.
    • Dans le tableau, sélectionnez les ensembles de données (BigQuery) ou les schémas (autres dialectes) à utiliser dans le modèle.
    • Une fois les ensembles de données ou les schémas sélectionnés, utilisez la flèche à droite de chaque nom d'ensemble de données ou de schéma pour ouvrir l'onglet Tables et sélectionner chaque table que vous souhaitez inclure. Des vues seront créées à partir des tables.
    • Une fois les tables sélectionnées, utilisez la flèche à droite de chaque nom de table pour ouvrir l'onglet Champs et sélectionner chaque champ que vous souhaitez inclure.
    • Ignorer les préfixes: si vous souhaitez ignorer les préfixes de table dans les noms des fichiers d'affichage générés, saisissez les préfixes de la base de données dans une liste d'éléments séparés par une virgule dans ce champ. 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 Ignorer les préfixes, Looker crée des fichiers de vue nommés orders et users.
    • Importer les descriptions des champs: cochez cette case pour utiliser toutes les descriptions de champs disponibles dans la base de données en tant que descriptions LookML pour les dimensions générées.
    • Cliquez sur le bouton Suivant pour enregistrer vos informations et passer à la section suivante.

  3. Sélectionner des clés primaires:

    • Sélectionnez une clé primaire pour chaque table que vous avez sélectionnée. Looker peut ainsi mieux joindre vos tables.
    • Cette étape est facultative. Pour l'ignorer, ne sélectionnez aucune clé primaire.
    • Cliquez sur le bouton Suivant pour enregistrer vos informations et passer à la section suivante.

  4. Sélectionner les explorations à créer:

    • Sélectionner chaque vue que vous souhaitez utiliser comme vue de base pour une exploration 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.
    • Cette étape est facultative. Pour l'ignorer, ne sélectionnez aucune vue.
    • Cliquez sur le bouton Suivant pour enregistrer vos informations et passer à la section suivante.

  5. Saisissez le nom du modèle:

  6. Cliquez sur l'un des boutons suivants pour générer les fichiers de modèle et, si vous le souhaitez, le nouveau projet:

    • Terminer et afficher le modèle: Looker vous redirige vers les fichiers de l'IDE Looker.
    • Compléter et explorer les données: Looker vous redirige vers l'exploration qui correspond au premier fichier de vue sélectionné dans la section Sélectionner les explorations à créer.

  7. Si vous avez créé un projet et que vous souhaitez l'associer à un autre dépôt que le dépôt Git nu que Looker a utilisé pour la création du projet, cliquez sur le bouton Réinitialiser la connexion Git dans l'onglet Configuration de la page Paramètres du projet du projet pour effectuer cette opération.

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 prévue 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 la configuration du modèle, la connexion n'est pas autorisée.

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

  • Lorsque vous déployez un modèle 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 qu'il est en mode Production. Lorsqu'un modèle est transféré du mode développement vers la 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 que le projet n'existe. Ensuite, lorsqu'un développeur LookML crée 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.

Configurer des modèles planifiés

Les administrateurs Looker peuvent utiliser le bouton Configurer un nouveau modèle en haut de la page Projets LookML pour ajouter une configuration à un modèle existant ou à un modèle planifié qui n'existe pas encore.

Configurer un modèle à l'avance est utile si les développeurs n'ont pas reçu l'autorisation manage_models ni l'autorisation manage_project_models. Si un administrateur configure le modèle pour les développeurs, ils pourront exécuter des requêtes dès qu'ils auront généré ou créé le fichier de modèle.

Les administrateurs peuvent également spécifier les connexions de base de données que le modèle peut utiliser, ou indiquer que le modèle est autorisé à utiliser toutes les connexions actuelles ou futures. Les développeurs Looker utilisent le paramètre LookML connection pour spécifier dans le fichier de modèle la connexion que le modèle doit utiliser. Si un développeur spécifie une connexion qu'un administrateur n'a pas autorisée dans la configuration du modèle, aucune requête sur ce modèle ne s'exécute.

Lorsqu'un administrateur configure un nouveau modèle à l'avance et crée un projet dans le cadre de cette configuration, ce projet s'affiche dans la section Projets en attente de la page Projets.

Générer un projet vide

Créer un projet vide peut être utile lorsque vous souhaitez créer vos fichiers LookML à partir de zéro.

La page Créer un modèle génère des projets avec des fichiers LookML inclus. Toutefois, vous pouvez réduire le nombre de fichiers LookML générés en ne remplissant que les sections suivantes de la page Créer un modèle:

  • Sélectionner la connexion à une base de données
  • Sélectionner les tables
  • Saisissez le nom du modèle

Laissez les sections restantes incomplètes.

Cliquez sur le bouton Terminer et afficher le modèle, qui vous permet d'accéder au projet dans l'IDE Looker. Une fois dans l'IDE, vous pouvez supprimer les fichiers LookML dont vous n'avez pas besoin pour créer un projet vide.

Étapes suivantes

Une fois un modèle ou un projet créé, vous pouvez effectuer les actions suivantes: