Générer un modèle à partir de données d'exemple

Découvrez comment utiliser Looker (Google Cloud Core) pour générer automatiquement un modèle de données de base à partir d'une connexion incluse dans chaque instance.

Chaque instance Looker (Google Cloud Core) est fournie avec l'exemple de projet LookML installé par défaut sur l'instance. L'exemple de projet LookML inclut des modèles LookML sélectionnés basés sur l'ensemble de données BigQuery public the Look eCommerce. L'exemple de projet LookML utilise une connexion, sample_bigquery_connection. Vous pouvez utiliser cette connexion pour générer un modèle de données basé sur l'une des tables de l'exemple de projet. Étant donné que ce démarrage rapide est uniquement destiné à des fins pédagogiques, vous supprimerez le modèle de données à la fin du processus.

Avant de commencer

Pour suivre ce guide de démarrage rapide, vous aurez besoin des éléments suivants :

  • Accès à une instance Looker (Google Cloud Core) incluant l'exemple de projet LookML.
  • Activez l'API BigQuery pour le Google Cloud projet qui contient votre instance Looker (Google Cloud Core).

    Activer l'API

Rôles requis

Pour suivre ce guide de démarrage rapide, vous devez disposer du rôle IAM (Identity and Access Management) et du rôle Looker appropriés.

Rôles de gestion de l'authentification et des accès (IAM)

Votre administrateur Looker (Google Cloud Core) vous accorde l'accès à l'application Looker (Google Cloud Core) via le système Identity and Access Management de Google Cloud.

Pour obtenir l'autorisation dont vous avez besoin pour accéder à l'application Looker (Google Cloud Core), demandez à votre administrateur de vous accorder le rôle IAM Utilisateur de l'instance Looker (roles/looker.instanceUser) sur le projet Google Cloud contenant l'instance Looker (Google Cloud Core). Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient l'autorisation looker.instances.login, qui est nécessaire pour accéder à l'application Looker (Google Cloud Core).

Vous pouvez également obtenir cette autorisation avec des rôles personnalisés ou d'autres rôles prédéfinis.

Autorisations Looker

Vous devez disposer du rôle Administrateur Looker ou de l'autorisation develop.

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

  1. Sur la page d'accueil de Looker (Google Cloud Core), cliquez sur l'icône Menu principal de Looker , puis activez le mode Développement en sélectionnant le bouton Mode Développement en bas du menu.
  2. Sur la page d'accueil de Looker (Google Cloud Core), cliquez sur le bouton Créer dans le menu de navigation principal pour ouvrir le menu déroulant.
  3. Dans le menu déroulant, sélectionnez Modèle LookML pour ouvrir la page Créer un modèle.

Définir le modèle

Sur la page Créer un modèle, procédez comme suit :

  1. Dans la section Sélectionner une connexion à une base de données, sélectionnez sample_bigquery_connection dans le menu déroulant.
  2. Sélectionnez la case d'option pour ajouter le modèle au projet sample_thelook_ecommerce, puis cliquez sur Next (Suivant).
  3. Dans la section Sélectionner des tables, conservez le projet Google Cloud par défaut dans le champ Sélectionner un projet GCP.
  4. Dans le champ Ensembles de données, sélectionnez bq_dataset.
  5. Cliquez sur la flèche à droite de bq_dataset pour accéder au champ Tables.
  6. Dans le champ Tables, sélectionnez bq_table.
  7. Cliquez sur la flèche à droite de bq_table pour accéder au champ Champs.
  8. Dans le champ Champs, sélectionnez tous les champs, puis cliquez sur Suivant.
  9. Dans la section Sélectionner les clés primaires, sélectionnez Nom comme clé primaire, puis cliquez sur Suivant.
  10. Dans la section Sélectionner les explorations à créer, sélectionnez le fichier bq_table.view, puis cliquez sur Suivant.
  11. Dans la section Saisir le nom du modèle, saisissez un nom de modèle unique.
  12. Cliquez sur le bouton Terminer et afficher le modèle. Cette action vous redirige vers l'IDE Looker.

Afficher votre modèle

Une fois que vous avez rempli tous les champs de la page Créer un modèle, affichez le modèle généré par Looker.

Afficher les fichiers de modèle dans l'IDE Looker

  1. Après avoir cliqué sur le bouton Terminer et afficher le modèle, vous serez redirigé vers l'IDE Looker. Dans l'explorateur de fichiers de l'IDE, vous voyez les dossiers des exemples de modèles LookML préexistants, à savoir 0_start_here, 1_basic_lookml, 2_intermediate_lookml et 3_advanced_lookml. Vous verrez également les dossiers créés pour le modèle généré, models et views.
  2. Développez les dossiers models et views pour afficher les fichiers LookML que Looker a créés pour le modèle que vous avez défini sur la page Créer un modèle. Le point bleu à côté de chaque fichier indique qu'il s'agit de nouveaux fichiers qui n'ont pas encore été déployés en production.
    • Le fichier .model définit le modèle. Dans le fichier de modèle, vous pouvez voir la connexion que vous avez sélectionnée, la vue bq_table, ainsi que d'autres configurations par défaut.
    • Le fichier bq_table.view définit la vue. Dans le fichier de vue, vous pouvez voir les champs birthdate, name et rating que vous avez sélectionnés, ainsi que leur définition dans la table de la base de données BigQuery. Vous y trouverez également une mesure count par défaut ajoutée par Looker.
  3. Vous voyez également le fichier README.md que Looker a généré, car la case à cocher Générer un fichier README contenant des informations supplémentaires sur l'utilisation de LookML sur la page Créer un modèle était sélectionnée par défaut.

Afficher le modèle sur la page "Projets LookML"

  1. Dans l'IDE, ouvrez le menu de navigation principal en cliquant sur l'icône Menu principal.
  2. Si vous n'êtes pas déjà dans le menu Develop (Développer), cliquez sur Develop.
  3. Dans le menu Développer, sélectionnez Projets pour accéder à la page Projets LookML.
  4. Affichez votre modèle dans la colonne Modèles de la ligne sample_thelook_ecommerce. Il s'affiche avec les modèles advanced_ecomm, basic_ecomm et intermediate_ecomm de l'exemple de projet LookML.

Afficher l'exploration créée par le modèle

  1. Sur la page Projets, cliquez sur le nom de votre modèle pour revenir au fichier de modèle dans l'IDE.
  2. Une fois le fichier de modèle ouvert dans l'IDE, cliquez sur la flèche Afficher les actions sur le fichier à côté du nom du fichier en haut de l'IDE.
  3. Sélectionnez Explorer la table Bq : nom_de_votre_modèle dans le menu déroulant. Cette sélection vous redirige vers l'exploration Table Bq créée par votre modèle.
  4. Dans le sélecteur de champs, notez les dimensions Date de naissance, Nom et Note que vous avez sélectionnées sur la page Créer un modèle, ainsi que la mesure Nombre par défaut.

Les fichiers de modèle, la configuration du modèle et les explorations que vous avez consultés ne sont disponibles que dans votre branche Git personnelle en mode Développement. Si vous souhaitez rendre ce modèle disponible pour d'autres utilisateurs de votre instance Looker (Google Cloud Core), vous devez valider vos modifications, fusionner votre branche et déployer la branche de production. Toutefois, pour les besoins de ce guide de démarrage rapide, vous allez supprimer ce modèle, comme décrit dans la section suivante.

Effectuer un nettoyage

Pour maximiser les performances de Looker, les modèles inutiles ne doivent pas être déployés en production. Pour conserver une branche Git personnelle propre et éviter de déployer accidentellement ce modèle en production, procédez comme suit pour supprimer le modèle :

  1. Dans l'exploration, cliquez sur le lien Accéder à LookML dans le sélecteur de champs. Cette action vous redirige vers l'IDE Looker.
  2. Dans l'IDE, sélectionnez l'icône Actions Git.
  3. Dans le menu Actions Git, cliquez sur Revenir à.

  4. Dans la fenêtre Revenir à, assurez-vous que l'option Rétablir les modifications non validées est sélectionnée, puis cliquez sur Confirmer.

  5. Dans l'IDE, vos fichiers de modèle ne devraient plus s'afficher.

  6. Pour supprimer la configuration du modèle, accédez à la page Projets en cliquant sur Projets dans le menu Développer.

  7. Recherchez votre modèle dans le tableau, puis cliquez sur le bouton Configurer sur la ligne correspondante.

  8. Assurez-vous d'être dans la fenêtre de votre modèle en vérifiant son nom dans le champ Modèle, puis cliquez sur Supprimer la configuration du modèle.

Étapes suivantes