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. 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 nouveau modèle de données basé sur l'une des tables de l'exemple de projet. Étant donné que ce démarrage rapide est à des fins pédagogiques uniquement, vous allez supprimer le modèle de données à la fin du processus.
Avant de commencer
Pour suivre ce guide de démarrage rapide, vous avez besoin des éléments suivants:
- Accès à une instance Looker (Google Cloud Core) qui inclut l'exemple de projet LookML.
- Une personne disposant du rôle IAM Administrateur Looker doit activer l'API BigQuery pour le projet Google Cloud contenant votre instance Looker (Google Cloud Core).
- Vous devez disposer du rôle Administrateur Looker ou de l'autorisation
develop
.
Accédez à la page "Créer un modèle".
- Sur la page d'accueil de Looker (Google Cloud Core), activez le mode de développement en activant l'option Mode de développement dans le menu de navigation principal.
- 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.
- 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:
- Dans la section Sélectionner une connexion de base de données, sélectionnez
sample_bigquery_connection
dans le menu déroulant. - Sélectionnez la case d'option pour ajouter le modèle au projet
sample_thelook_ecommerce
, puis cliquez sur Next (Suivant). - Dans la section Sélectionner des tables, laissez le projet par défaut Google Cloud dans le champ Sélectionner un projet GCP.
- Dans le champ Ensembles de données, sélectionnez
bq_dataset
. - Cliquez sur la flèche située à droite de
bq_dataset
pour accéder au champ Tables. - Dans le champ Tables, sélectionnez
bq_table
. - Cliquez sur la flèche située à droite de
bq_table
pour accéder au champ Champs. - Dans le champ Champs, sélectionnez tous les champs, puis cliquez sur Suivant.
- Dans la section Sélectionner des clés primaires, sélectionnez Nom comme clé primaire, puis cliquez sur Suivant.
- Dans la section Sélectionner les explorations à créer, sélectionnez le fichier
bq_table.view
, puis cliquez sur Suivant. - Dans la section Enter Model Name (Saisir le nom du modèle), saisissez un nom de modèle unique.
- 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, consultez le modèle généré par Looker.
Afficher les fichiers de modèle dans l'IDE Looker
- Après avoir cliqué sur le bouton Complete and View Model (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
et3_advanced_lookml
. Les dossiers créés pour le modèle généré,models
etviews
, s'affichent également. - Développez les dossiers
models
etviews
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 vuebq_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 champsbirthdate
,name
etrating
que vous avez sélectionnés et la façon dont ils sont définis dans la table de la base de données BigQuery, ainsi qu'une mesurecount
par défaut ajoutée par Looker.
- Le fichier
- Vous voyez également le fichier
README.md
généré par Looker, car la case Generate a Readme file that gives more information on using LookML (Générer un fichier README contenant des informations supplémentaires sur l'utilisation de LookML) de la page Create a Model (Créer un modèle) était cochée par défaut.
Afficher le modèle sur la page "Projets LookML"
- Dans l'IDE, ouvrez le menu de navigation principal en cliquant sur l'icône Menu principal.
- Si vous n'êtes pas déjà dans le menu Develop (Développer), cliquez dessus.
- Dans le menu Développer, sélectionnez Projets pour accéder à la page Projets LookML.
- 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
etintermediate_ecomm
de l'exemple de projet LookML.
Afficher l'exploration créée par le modèle
- Sur la page Projects (Projets), cliquez sur le nom de votre modèle pour revenir au fichier de modèle dans l'IDE.
- 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.
- Sélectionnez Explorer la table Bq : votre_nom_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.
- Dans l'outil de sélection 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 l'exploration 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 commettre 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, vous ne devez pas déployer de modèles inutiles en production. Pour maintenir une branche Git personnelle propre et éviter de déployer accidentellement ce modèle en production, procédez comme suit pour le supprimer:
- Dans l'exploration, cliquez sur le lien Accéder à LookML dans le sélecteur de champ. Cette action vous redirige vers l'IDE Looker.
- Dans l'IDE, sélectionnez l'icône Actions Git.
- Dans le menu Actions Git, cliquez sur Revenir à.
Dans la fenêtre Revenir à, assurez-vous que l'option Annuler les modifications non validées est sélectionnée, puis cliquez sur Confirmer.
Dans l'IDE, vos fichiers de modèle ne devraient plus s'afficher.
Pour supprimer la configuration du modèle, accédez à la page Projects (Projets) en cliquant sur Projects (Projets) dans le menu Develop (Développer).
Recherchez votre modèle dans le tableau, puis cliquez sur le bouton Configurer sur sa ligne.
Assurez-vous d'être 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
- Générer un modèle LookML
- Présentation de Looker IDE
- Gérer les fichiers et les dossiers LookML
- Modèles LookML courants
- Utiliser le contrôle des versions et le déploiement