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

Générez automatiquement un modèle de données de base dans Looker (Google Cloud Core) à partir d'une connexion incluse avec chaque instance. Chaque instance Looker (Google Cloud Core) inclut un exemple de projet LookML par défaut. Ce projet contient des modèles LookML organisés qui font référence à l'ensemble de données public BigQuery the Look eCommerce.

Dans ce guide de démarrage rapide, vous allez utiliser sample_bigquery_connection de Looker (Google Cloud Core) pour générer un modèle de données à partir de l'une des tables du projet. Cette procédure est fournie à des fins d'instruction uniquement. Vous supprimerez donc le modèle de données à la fin.

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 contenant 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 Identity and Access Management (IAM) et du rôle Looker appropriés.

Rôles de Identity and Access Management

Votre administrateur Looker (Google Cloud Core) vous accorde l'accès à l'application Looker (Google Cloud Core) via le système de Identity and Access Management de Google Cloud 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 d'instance Looker (roles/looker.instanceUser) sur le Google Cloud projet 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' looker.instances.login autorisation, qui est requise 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 et 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 le bouton radio pour ajouter le modèle au projet sample_thelook_ecommerce, puis cliquez sur Suivant.
  3. Dans la section Sélectionner des tables, laissez le projet par défaut Google Cloud 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 des 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 permet d'accéder à 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 accédez à 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 voyez é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 ne sont pas encore 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 et comment ils sont définis dans la table de base de données BigQuery, ainsi qu'une mesure count par défaut que Looker a ajoutée.
  3. Vous voyez également le fichier README.md que Looker a généré, car la case Générer un fichier README contenant des informations supplémentaires sur l'utilisation de LookML de la page Créer un modèle était coché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 Développer, cliquez sur Développer.
  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 de 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 permet d'accéder à 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 Évaluation que vous avez sélectionnées sur cette 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 l'exploration que vous avez consultés ne sont disponibles que dans votre branche Git personnelle en mode Développement. Si vous souhaitez mettre ce modèle à la disposition 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.

Libérer de l'espace

Pour optimiser 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 permet d'accéder à 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 Rétablir, assurez-vous que l'option Rétablir les modifications non validées est sélectionnée, puis cliquez sur Confirmer.

  5. Dans l'IDE, vous ne devriez plus voir vos fichiers de modèle.

  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 dans sa ligne.

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

Étape suivante