Utiliser l'exemple de projet LookML sur une instance Looker (Google Cloud Core)

Looker (Google Cloud Core) fournit un exemple de projet LookML qui peut vous aider à :

L'exemple de projet LookML est fourni sur les instances Looker (Google Cloud Core) de tous les types d'édition.

L'exemple de projet LookML sur les instances Looker (Google Cloud Core) inclut des modèles LookML organisés basés sur l'ensemble de données BigQuery public the Look eCommerce. Ce projet est un bon point de départ pour apprendre à créer vos propres modèles LookML et à modifier des modèles existants afin de personnaliser l'expérience utilisateur.

Lorsque vous créez une instance Looker (Google Cloud Core), l'exemple de projet LookML est déjà configuré sur votre instance en tant que dépôt nu à l'aide des identifiants par défaut de l'application (ADC) pour se connecter à une base de données BigQuery gérée par Google.

Avant de commencer : activer l'API BigQuery

Avant de pouvoir modifier le code LookML, interroger les explorations et afficher les exemples de tableaux de bord à partir de l'exemple de projet LookML, une personne disposant du rôle IAM Administrateur Looker doit activer l'API BigQuery pour le Google Cloud projet qui contient votre instance Looker (Google Cloud Core). Une fois l'API activée, actualisez la page de la console pour confirmer qu'elle a bien été activée.

Activer l'API

Afficher l'exemple de projet LookML et interagir avec lui

Vous pouvez afficher l'exemple de projet LookML en accédant au projet nommé sample_thelook_ecommerce dans l'IDE Looker. Le projet sample_thelook_ecommerce comprend quatre dossiers : 0_start_here, 1_basic_lookml, 2_intermediate_lookml et 3_advanced_lookml. Ces dossiers incluent les éléments suivants :

  • Fichiers README.md contenant des instructions et des explications sur les concepts LookML de base, intermédiaires et avancés
  • Modèles LookML prédéfinis avec une connexion à l'exemple de connexion BigQuery sample_bigquery_connection
  • Explorations et vues LookML prédéfinies que vous pouvez personnaliser

En suivant les instructions des fichiers README.md du projet, vous pouvez apprendre à modifier l'exemple de code LookML et voir comment ces modifications affectent l'interface d'exploration. L'exemple de projet LookML inclut également des tableaux de bord prédéfinis que vous pouvez ajouter et modifier pour créer des exemples d'analyses.

Accéder aux fichiers du projet LookML et les modifier

Pour accéder aux fichiers LookML dans l'exemple de projet LookML, procédez comme suit :

  1. Dans le panneau de navigation de gauche, sélectionnez Develop (Développer) pour ouvrir le menu Develop (Développer).
  2. Sélectionnez le projet sample_thelook_ecommerce. Par défaut, l'accès à l'exemple de projet ouvre le fichier START_HERE_README.md.
  3. Lisez les instructions dans les fichiers START_HERE_README.md ou accédez à un autre fichier de projet.
  4. Si vous souhaitez commencer à tester les modifications apportées au code LookML, passez en mode Développement et suivez les instructions du fichier README.md.

Créer des requêtes à l'aide des exemples d'explorations

Par défaut, l'exemple de projet LookML comporte les explorations suivantes :

  • 1) Basic Ecommerce (E-commerce de base)
  • 2) Intermediate Ecommerce (E-commerce intermédiaire)
  • 3) Intermediate Ecommerce (Valid Orders only) (E-commerce intermédiaire, commandes valides uniquement)
  • 4) Advanced Ecommerce (Valid Orders only) (E-commerce avancé, commandes valides uniquement)

Pour accéder aux exemples d'explorations, procédez comme suit :

  1. Dans le panneau de navigation de gauche, sélectionnez Explore (Explorer) pour ouvrir le menu Explore (Explorer).
  2. Dans le menu Explore (Explorer), sélectionnez l'un des exemples d'explorations.

Pour en savoir plus sur l'interrogation de données avec des explorations, suivez les instructions des fichiers README.md ou consultez la page Afficher les explorations et interagir avec elles dans Looker.

Afficher et modifier les exemples de tableaux de bord

Par défaut, lorsque vous créez votre instance, elle contient les exemples de tableaux de bord définis par l'utilisateur suivants à partir de l'exemple de projet :

  • Business Pulse - Basic visualization examples (Exemples de visualisations de base)
  • Business Pulse - Intermediate visualization examples (Exemples de visualisations intermédiaires)
  • Business Pulse - Advanced visualization examples (Exemples de visualisations avancées)

Bien que l'instance ne contienne aucun autre contenu, tel que des Looks ou des tableaux de bord créés par l'utilisateur, ces exemples de tableaux de bord s'affichent sur la page d'accueil prédéfinie de l'instance.

De plus, ces exemples de tableaux de bord s'affichent dans le dossier Shared folders (Dossiers partagés) (appelé Your organization's folder (Dossier de votre organisation)) de votre instance.

Pour accéder aux exemples de tableaux de bord dans le dossier Shared folders (Dossiers partagés), procédez comme suit :

  1. Dans le panneau de navigation de gauche, sélectionnez Folders (Dossiers).
  2. Sur la page All folders (Tous les dossiers), sélectionnez Shared folders (Dossiers partagés).
  3. Sur la page Your organization's folders (Dossiers de votre organisation), sélectionnez l'un des exemples de tableaux de bord.

Vous pouvez ensuite afficher les tableaux de bord et les modifier. Pour en savoir plus, consultez les pages Afficher des tableaux de bord et Modifier des tableaux de bord définis par l'utilisateur.

Effectuer une série de guides de démarrage rapide à l'aide de l'exemple de projet LookML

Si votre instance Looker (Google Cloud Core) est configurée avec l'exemple de projet LookML, vous pouvez utiliser la série de guides de démarrage rapide suivante pour découvrir les différentes étapes à suivre pour commencer à utiliser Looker (Google Cloud Core), de la connexion à votre entrepôt de données à la création et au partage de tableaux de bord avec des visualisations enrichies. Les guides de démarrage rapide vous présentent les procédures Looker courantes à l'aide de l'exemple de projet LookML. Une fois que vous maîtrisez ces procédures, vous pouvez appliquer les étapes à vos propres connexions de données et ensembles de données.

Les guides de démarrage rapide suivants sont présentés dans l'ordre généralement requis pour configurer et utiliser une instance Looker à partir de zéro. Toutefois, comme les guides de démarrage rapide utilisent l'exemple de projet LookML, vous pouvez les effectuer indépendamment les uns des autres, dans l'ordre de votre choix :

  1. Créer une connexion pour une instance IP publique : découvrez comment créer une connexion de base de données pour une instance IP publique Looker (Google Cloud Core) à utiliser comme base pour n'importe quel projet LookML ou pour un projet LookML spécifique.
  2. Générer un modèle à partir d'exemples de données : 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.
  3. Modéliser vos données : découvrez comment ajouter des dimensions, des mesures et des filtres supplémentaires au modèle généré à partir d'exemples de données.
  4. Créer un tableau de bord avec des exemples de données : découvrez comment créer un tableau de bord avec des exemples de données à partir de l'exploration Intermediate Ecommerce (E-commerce intermédiaire) dans l'exemple de projet LookML sur votre instance Looker (Google Cloud Core).
  5. Créer un Look avec des exemples de données : découvrez comment interroger et visualiser des données dans Looker, et comment enregistrer les résultats de votre requête en tant que Look que vous pouvez partager et réutiliser.

Modifier l'accès des utilisateurs au projet

Par défaut, les utilisateurs disposant de l'un des rôles Looker par défaut auront l'ensemble de modèles All (Tous) défini sur votre instance Looker (Google Cloud Core). Par conséquent, par défaut, tous les utilisateurs pourront accéder à tous les modèles définis dans le projet sample_thelook_ecommerce.

Si vous souhaitez empêcher des utilisateurs spécifiques d'afficher ou d'interagir avec un ou plusieurs modèles du projet, vous pouvez créer un ensemble de modèles qui n'inclut pas les modèles dans sample_thelook_ecommerce. Créez ensuite un rôle ou mettez à jour un rôle existant lié au nouvel ensemble de modèles plus limité.

Supprimer l'exemple de projet LookML

Vous pouvez supprimer l'exemple de projet et de connexion de votre instance. Pour supprimer le projet, suivez les instructions de la section Accéder aux informations sur le projet et les modifier.

Vous pouvez également supprimer la connexion sample_bigquery_connection en suivant les instructions de la page de documentation Connexions.

Étape suivante