Utiliser le canevas de modélisation visuelle

Bêta : Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section Conditions générales du service des Conditions spécifiques du service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Si vous rencontrez un problème ou si vous avez des commentaires lors de la version Preview publique du canevas de modélisation visuelle, signalez-le à [e-mail].

Le canevas de modélisation visuelle de Looker vous permet de vous connecter à des sources de données BigQuery afin de créer et de modifier des modèles de données LookML à l'aide d'un canevas interactif par glisser-déposer. Avec le canevas de modélisation visuelle, vous pouvez joindre visuellement des tables, définir des dimensions et des mesures, prévisualiser les résultats des requêtes en temps réel et publier des explorations sans écrire de code LookML.

Composants du canevas

Le canevas de modélisation visuelle comprend les composants d'espace de travail et les onglets de navigation suivants :

• Base de données Sources : barre latérale dans laquelle vous pouvez effectuer des recherches et qui affiche les ensembles de données, les tables et les vues de base de données disponibles sur la connexion active
• Canevas visuel graph_4 : espace de travail principal dans lequel vous faites glisser des tables, organisez les nœuds de table et définissez des relations de jointure
• Code LookML code : panneau qui affiche le code LookML généré qui se trouve derrière votre modèle visuel
• Aperçu des données table_chart : panneau inférieur réductible qui affiche un aperçu de la requête en temps réel (LIMIT 100) de l'ensemble de données joint
• Éditeur de champs edit_attributes : panneau permettant d'ajouter, de renommer et de personnaliser des dimensions et des mesures

Avant de commencer

Pour utiliser le canevas de modélisation visuelle, vous devez disposer des éléments suivants :

• Une instance Looker exécutant Looker 26.14 ou une version ultérieure, configurée par un administrateur Looker pour activer les explorations en libre-service
• Une connexion à une base de données BigQuery configurée avec les paramètres suivants :
  • Configurée avec le champ d'application Tous les projets dans l'onglet Bases de données de la page Connexions
  • Configurée pour l'authentification avec OAuth
• Un compte utilisateur Looker disposant de l'autorisation create_self_service_from_table
• Un compte Google disposant des rôles IAM suivants pour les tables BigQuery cibles :
  • bigquery.jobUser
  • bigquery.dataViewer

Créer un modèle visuel

Les sections suivantes décrivent les étapes à suivre pour créer un modèle de données à l'aide du canevas de modélisation visuelle :

1. Connectez-vous à votre base de données
2. Ajoutez des tables au canevas
3. Définissez des relations et des jointures
4. Ajoutez et configurez des mesures et des dimensions
5. Prévisualisez vos données en temps réel
6. Affichez le code LookML de votre modèle
7. Publiez votre modèle dans une exploration

Connectez-vous à votre base de données

Pour vous connecter à votre base de données, procédez comme suit :

1. Dans Looker, cliquez sur le bouton Créer dans le menu de navigation principal.
2. Sélectionnez Source de données.
3. Dans la boîte de dialogue Créer une source de données, sélectionnez l'onglet Se connecter à une base de données.
4. Choisissez une connexion à une base de données dans le menu déroulant Connexion BigQuery.
5. Spécifiez votre projet :
   • Sélectionnez Sélectionner dans la liste pour choisir parmi les projets disponibles sur la connexion.
   • Sélectionnez Saisir manuellement pour saisir directement l'ID du projet.
6. Indiquez si vous souhaitez inclure toutes les tables ou en sélectionner des spécifiques :
   • Sélectionnez Inclure tous les ensembles de données et toutes les tables de ce projet sélectionné pour commencer avec un canevas vide. À partir du canevas vide, vous pouvez ajouter des tables à partir de votre liste de sources.
   • Sélectionnez Choisir une table spécifique pour spécifier un seul ensemble de données et une seule table à ajouter au canevas. Le canevas de modélisation visuelle s'ouvre dans l'éditeur de champs et charge les champs de la table sélectionnée. Vous pouvez cliquer sur Canevas visuel graph_4 dans la barre de navigation pour afficher la table dans le canevas. Vous pouvez ajouter d'autres tables à partir de votre liste de sources.
7. Cliquez sur Continuer pour ouvrir le canevas de modélisation visuelle.

Ajouter des tables au canevas

Pour ajouter des tables au canevas afin de commencer à modéliser vos données, procédez comme suit :

1. Dans la barre latérale de la base de données Sources , parcourez ou recherchez les ensembles de données, les tables ou les vues que vous souhaitez modéliser.
2. Faites glisser chaque table de la barre latérale vers le canevas.
3. Repositionnez les nœuds de table sur le canevas pour organiser la mise en page de votre modèle de données.

Lorsque vous faites glisser une table vers le canevas, le canevas de modélisation visuelle la représente sous la forme d'un nœud de table. Le canevas affiche le nom de la table, ainsi que son projet BigQuery et son ID d'ensemble de données. La première table ajoutée au canevas est libellée Vue de base.

Définir des relations et des jointures

Lorsque vous ajoutez plusieurs tables au canevas, le canevas de modélisation visuelle recherche les noms de colonnes correspondants (par exemple, order_id dans orders et order_items) et propose automatiquement une ligne de connexion de jointure entre les tables.

Pour modifier ou créer des relations entre les tables de votre base de données, procédez comme suit :

1. Cliquez sur la ligne de connexion de jointure entre deux nœuds de table pour ouvrir le panneau Configuration de la jointure. Configurez la jointure dans le panneau Configuration de la jointure :
   • Type de jointure : sélectionnez le type de jointure (Externe gauche, Interne ou Externe complète). Par défaut, Looker utilise une jointure externe gauche.
   • Relation (cardinalité) : sélectionnez le type de relation (Un à un, Un à plusieurs, Plusieurs à un ou Plusieurs à plusieurs).
   • Clause de jointure : examinez les clés de jointure suggérées automatiquement ou ajoutez des conditions de jointure personnalisées. Vous pouvez spécifier plusieurs conditions de jointure (par exemple, orders.id = order_items.order_id AND orders.date = order_items.date).
2. Résoudre les erreurs de jointure : si une jointure crée un chemin SQL non valide ou une référence circulaire, la ligne de connexion devient rouge et une info-bulle explicative s'affiche. Ajustez les clés de jointure ou la cardinalité de la relation pour résoudre l'erreur.
3. Si vous avez modifié les paramètres de jointure, cliquez sur Appliquer pour appliquer vos modifications à la jointure.

Ajouter et configurer des mesures et des dimensions

Le canevas de modélisation visuelle configure automatiquement les dimensions et les mesures de vos tables, et vous permet d'ajouter des calculs personnalisés. Par défaut, le canevas de modélisation visuelle crée une mesure de type count ou sum pour les champs numériques, tout en conservant les champs dont le nom contient ID, Key ou Code en tant que dimensions numériques. Lorsque vous définissez une relation Un à plusieurs, le canevas de modélisation visuelle applique automatiquement une logique d'agrégation symétrique pour éviter les erreurs de calcul de valeurs en distribution ramifiée et en double.

Vous ne pouvez pas supprimer un champ généré. Vous ne pouvez que le masquer, soit en sélectionnant Masquer dans le menu Outils du champ dans l'éditeur de champs, soit en cliquant sur l'icône Modifier edit du champ et en cochant la case Masquer ce champ dans les explorations et les visualisations.

Pour afficher les champs d'une table, sélectionnez le nœud de table dans le canevas, puis cliquez sur Modifier les champs.

Dans l'éditeur de champs, vous pouvez effectuer les tâches suivantes :

• Modifier une dimension
• Modifier une mesure
• Créer une dimension personnalisée
• Créer une mesure personnalisée

Modifier une dimension

Pour modifier une dimension existante, procédez comme suit :

1. Dans le canevas de modélisation visuelle, sélectionnez un nœud de table dans le canevas, puis cliquez sur Modifier les champs pour ouvrir l'éditeur de champs.
2. Dans l'éditeur de champs, cliquez sur l'onglet Dimensions.
3. Recherchez la dimension que vous souhaitez modifier, puis cliquez sur l'icône Modifier edit du champ pour ouvrir la boîte de dialogue Modifier la dimension.
4. Mettez à jour l'un des champs suivants (le champ Type de données est en lecture seule) :
   • Format : sélectionnez une option de mise en forme dans le menu déroulant.
   • Nom : modifiez le nom utilisé pour identifier la dimension dans LookML et les expressions.
   • Libellé : modifiez le libellé qui s'affiche dans les explorations et les visualisations.
   • + Ajouter une description : cliquez sur cette option pour saisir ou modifier une description facultative de la dimension.
   • Masquer ce champ dans les explorations et les visualisations : cochez ou décochez cette case pour masquer ou afficher la dimension.
5. Cliquez sur Enregistrer.

Modifier une mesure

Pour modifier une mesure existante, procédez comme suit :

1. Dans le canevas de modélisation visuelle, sélectionnez un nœud de table dans le canevas, puis cliquez sur Modifier les champs pour ouvrir l'éditeur de champs.
2. Dans l'éditeur de champs, cliquez sur l'onglet Mesures.
3. Recherchez la mesure que vous souhaitez modifier, puis cliquez sur l'icône Modifier edit du champ pour ouvrir la boîte de dialogue Modifier la mesure.

4. Mettez à jour l'un des champs suivants :

   Remarque : Pour les mesures de comptage, vous ne pouvez modifier que Libellé, Format, Description et Masquer ce champ dans les explorations et les visualisations.
   • Champ à mesurer : sélectionnez le champ que vous souhaitez agréger dans le menu déroulant.
   • Type de mesure : sélectionnez le type d'agrégation (par exemple, Somme, Nombre, Moyenne, Min ou Max) dans le menu déroulant.
   • Libellé : modifiez le libellé qui s'affiche dans les explorations et les visualisations.
   • Onglet "Filtres" : sous Limiter les résultats, sélectionnez un champ dans le menu déroulant Nom du filtre et spécifiez une Valeur du filtre. Utilisez les boutons + et - pour ajouter ou supprimer des conditions de filtre.
   • Onglet "Détails du champ" : sélectionnez une option de mise en forme dans le menu déroulant Format et saisissez une Description facultative (jusqu'à 255 caractères).
   • Masquer ce champ dans les explorations et les visualisations : cochez ou décochez cette case pour masquer ou afficher la mesure.

5. Cliquez sur Enregistrer.

Créer une dimension personnalisée

Pour créer une dimension personnalisée à l'aide d'une expression Looker, procédez comme suit :

1. Dans le canevas de modélisation visuelle, sélectionnez un nœud de table dans le canevas, puis cliquez sur Modifier les champs pour ouvrir l'éditeur de champs.
2. Dans l'éditeur de champs du canevas de modélisation visuelle, cliquez sur Ajouter une dimension pour ouvrir la boîte de dialogue Créer une dimension.
3. Dans la zone de l'éditeur d'expressions, saisissez une expression Looker qui définit la dimension ou cliquez sur Aide-moi à écrire une expression avec Gemini pour générer une expression.
4. Sélectionnez une option de mise en forme dans le menu déroulant Format.
5. Saisissez un Nom et un Libellé pour la dimension.
6. Si vous le souhaitez, cliquez sur + Ajouter une description pour saisir ou modifier une description de la dimension.
7. Si vous le souhaitez, cochez la case Masquer ce champ dans les explorations et les visualisations pour masquer la dimension.
8. Cliquez sur Enregistrer.

Créer une mesure personnalisée

Pour créer une mesure personnalisée, procédez comme suit :

1. Dans le canevas de modélisation visuelle, sélectionnez un nœud de table dans le canevas, puis cliquez sur Modifier les champs pour ouvrir l'éditeur de champs.
2. Dans l'éditeur de champs, cliquez sur l'onglet Mesures , puis sur Ajouter une mesure pour ouvrir la boîte de dialogue Créer une mesure.
3. Sélectionnez le champ que vous souhaitez agréger dans le menu déroulant Champ à mesurer.
4. Dans le menu déroulant Type de mesure, sélectionnez le type d'agrégation que vous souhaitez effectuer sur le champ Champ à mesurer.
5. Saisissez un Libellé pour la mesure.
6. Configurez des conditions de filtre ou des détails de mise en forme facultatifs :
   • Onglet "Filtres" : sous Limiter les résultats, sélectionnez un champ dans le menu déroulant Nom du filtre et spécifiez une Valeur du filtre. Utilisez les boutons + et - pour ajouter ou supprimer des conditions de filtre.
   • Onglet "Détails du champ" : sélectionnez une option de mise en forme dans le menu déroulant Format et saisissez une Description facultative (jusqu'à 255 caractères).
7. Si vous le souhaitez, cochez la case Masquer ce champ dans les explorations et les visualisations pour masquer la mesure.
8. Cliquez sur Enregistrer.

Prévisualiser vos données en temps réel

Pour vérifier la sortie de données de votre modèle, procédez comme suit :

1. Dans le canevas de modélisation visuelle, cliquez sur l'onglet Aperçu des données table_chart dans la barre de navigation.
2. Cliquez sur une table dans le canevas pour sélectionner des champs dans cette table.
3. Dans le volet d'aperçu des données, cliquez sur le menu déroulant Colonnes d'aperçu.

4. Dans le menu déroulant, sélectionnez les champs de la table que vous souhaitez interroger, puis cliquez sur Aperçu.

   Le canevas de modélisation visuelle interroge votre base de données et affiche les résultats de la requête dans un tableau du volet d'aperçu des données.

5. Inspectez les données pour vous assurer qu'aucune distribution ramifiée de lignes ni aucun enregistrement supprimé ne se produit de manière involontaire.

6. Modifiez les jointures ou les champs si nécessaire, puis cliquez sur Actualiser le schéma dans le volet d'aperçu des données pour mettre à jour la table.

Afficher le code LookML

Cliquez sur l'onglet Code LookML code pour inspecter le code LookML généré pour votre modèle. Le code LookML des modèles visuels est en lecture seule. Si vous souhaitez modifier des champs et des jointures, utilisez le canevas de modélisation visuelle.

Publier votre modèle dans une exploration

Pour enregistrer votre modèle, cliquez sur le bouton Explorer les données dans le canevas de modélisation visuelle.

Looker génère les fichiers de modèle LookML sous-jacents et enregistre les coordonnées de mise en page du canevas. Votre modèle est désormais publié et prêt à être interrogé.

Accéder aux modèles visuels

Les modèles visuels publiés apparaissent dans la navigation Looker sous Explorer dans la section Explorations en libre-service.

Pour interroger un modèle visuel, procédez comme suit :

1. Dans Looker, cliquez sur Explorer dans le menu de navigation principal.
2. Sous Explorations en libre-service, sélectionnez le nom de l'exploration de votre modèle.
3. Sélectionnez des dimensions et des mesures dans le sélecteur de champs, ajoutez des filtres et exécutez des requêtes pour créer des visualisations et des vignettes de tableau de bord.

Modifier un modèle visuel existant

Pour modifier un modèle existant créé avec le canevas de modélisation visuelle, procédez comme suit :

1. Dans Looker, cliquez sur Explorer dans le menu de navigation principal.
2. Sous Explorations en libre-service, ouvrez l'exploration du modèle que vous souhaitez modifier.
3. Sélectionnez Modifier le modèle dans le sélecteur de champs de l'exploration pour ouvrir le canevas de modélisation visuelle. Si vous utilisez l'expérience d'exploration classique, sélectionnez Modifier le modèle dans le menu Outils de l'exploration.
4. Apportez vos modifications dans le canevas de modélisation visuelle (par exemple, ajoutez des tables, mettez à jour des clauses de jointure ou créez des mesures).
5. Cliquez sur Explorer les données pour mettre à jour le modèle.

Remarque : Si plusieurs utilisateurs modifient le même modèle visuel, la version enregistrée la plus récente est conservée.

Supprimer un modèle visuel

Pour supprimer un modèle visuel, procédez comme suit :

1. Dans Looker, cliquez sur Explorer dans le menu de navigation principal.
2. Sous Explorations en libre-service, ouvrez l'exploration du modèle que vous souhaitez modifier.
3. Sélectionnez Modifier le modèle dans le sélecteur de champs de l'exploration pour ouvrir le canevas de modélisation visuelle. Si vous utilisez l'expérience d'exploration classique, sélectionnez Modifier le modèle dans le menu Outils de l'exploration.
4. Dans le canevas de modélisation visuelle, sélectionnez Supprimer dans le menu à trois points.