--- title: "Utiliser le visual builder" description: "Le visual builder offre un moyen générique d'interroger des informations stockées à l'aide d'un framework propriétaire spécifique construit au-dessus de moteurs de requêtes open source" url: https://docs.ovhcloud.com/fr/guides/public-cloud/data-platform/analytics-manager-queries-visual-builder lang: fr lastUpdated: 2026-09-14 --- > For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/fr/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/fr/llms-full.txt. # Utiliser le visual builder ## Objectif Le visual builder offre un **moyen générique d'interroger des informations stockées** à l'aide d'un framework propriétaire spécifique construit au-dessus de moteurs de requêtes open source. Les requêtes sont créées en renseignant les 4 champs suivants avec des **attributs** issus de votre [Lakehouse Manager](https://docs.ovhcloud.com/fr/guides/public-cloud/data-platform/landing-page-lakehouse-manager.md) : - [Data](#configurer-le-champ-data) : les mesures que vous souhaitez agréger - [Scale](#configurer-le-champ-scale) : les dimensions selon lesquelles vous souhaitez grouper vos données - [Filter](#configurer-le-champ-filter) : pour filtrer les résultats de votre requête - [Order](#configurer-le-champ-order) : pour trier les résultats de votre requête De plus, vous pouvez définir une _limite_ au nombre de lignes renvoyées par l'interface à l'aide du widget situé à côté du bouton Run. Cette limite ne sera pas enregistrée dans la requête pour les processus en aval (API et apps). ![Visual overview](/images/public-cloud/data-platform/product/am/queries/picts/visual-overview.png) [Découvrez comment configurer une requête](#configurer-le-champ-data) ### Comment cela fonctionne-t-il ? Supposons par exemple que les personnes en charge du développement des tableaux de bord de visualisation souhaitent afficher une courbe de chiffre d'affaires (attribut : _income_) par date (attribut : _date_). ![How does it work? — Usecase1](/images/public-cloud/data-platform/product/am/queries/picts/usecase1.png) 1. L'interface du visual builder peut être utilisée pour spécifier les données à afficher (_**data**_ : _income_), et la métrique selon laquelle grouper ces données (_**scale**_ : _date_). 2. À ce stade, le builder détermine automatiquement quelle table est la plus appropriée pour la requête - la **plus petite contenant tous les attributs requis**. Dans l'exemple, "agr\_shop\_date", qui est une table avec des données de revenus agrégées par dates, sera sélectionnée et interrogée. :::info Le visual builder ne vous demande pas de spécifier une table. Cela garantit que votre Projet peut facilement évoluer dans le temps à mesure que le système de stockage que vous utilisez pour vos données varie (nature, quantité d'informations stockées, schéma du data warehouse, etc.) ::: 3. Enfin, les résultats sont renvoyés à l'utilisateur sous forme d'[objet JSON léger, agnostique du SGBD](#découvrir-le-format-de-réponse). ![How does it work? — Usecase2](/images/public-cloud/data-platform/product/am/queries/picts/usecase2.png) ## Configurer le champ Data Dans le champ _Data_, saisissez les **attributs que vous souhaitez afficher**. Il est possible d'agréger les données à afficher, à l'aide de [fonctions d'agrégation simples](#fonctions-dagrégation). ![Configure the field Data — Visual data1](/images/public-cloud/data-platform/product/am/queries/picts/visual-data1.png) Vous pouvez ajouter autant d'attributs que vous le souhaitez tant qu'ils existent dans la même table, sinon une erreur sera renvoyée. La liste des attributs disponibles dans l'interface est automatiquement filtrée pour n'afficher que les autres attributs disponibles. Vous [n'avez pas besoin de spécifier la table](#choix-de-la-table). Utilisez le widget à gauche de l'écran pour obtenir des métadonnées sur les tables et attributs que vous souhaitez interroger. ![Configure the field Data — Visual table details](/images/public-cloud/data-platform/product/am/queries/picts/visual-table-details.png) ### Fonctions d'agrégation - **SELECT** : la fonction _SELECT_ affiche simplement la valeur de l'attribut sélectionné. Elle sélectionnera la première valeur de la liste si plusieurs valeurs sont renvoyées. - **SUM** : la fonction _SUM_ est utilisée pour calculer la somme totale des valeurs d'un attribut. - **COUNT** : la fonction _COUNT_ est utilisée pour compter le nombre d'occurrences renvoyées par la requête. - **COUNT DISTINCT** : la fonction _COUNT DISTINCT_ est utilisée pour compter le nombre de valeurs différentes uniques d'un attribut. - **MIN & MAX** : les fonctions _MIN_ & _MAX_ sont utilisées pour afficher les valeurs minimale et maximale d'un attribut. - **SELECT DISTINCT** : la fonction _SELECT DISTINCT_ est utilisée pour afficher les valeurs différentes uniques d'un attribut. - **AVG** : la fonction _AVG_ est utilisée pour calculer la moyenne arithmétique d'un attribut. ### Choix de la table Le visual builder ne vous demande pas de spécifier une table. Par défaut, la Platform détermine la table la plus adaptée à la requête : il s'agit de la table contenant tous les attributs des champs data, scale, filter et order qui possède le moins de lignes. Si vous souhaitez forcer la requête sur une table spécifique, vous pouvez toujours passer outre les tables choisies automatiquement par le système et sélectionner la vôtre en cliquant sur l'**icône de table** à côté de _Data_. ![Choice of table — Visual force table](/images/public-cloud/data-platform/product/am/queries/picts/visual-force-table.png) :::info Forcer la table interrogée peut être utile lorsque certains noms d'attributs (comme "date") sont communs à un grand nombre de tables. Cependant, ce n'est pas une bonne pratique car l'Analytics Manager est conçu pour récupérer les données en utilisant un chemin optimal afin de réduire le temps d'exécution. ::: ## Configurer le champ Scale Dans le champ _Scale_, saisissez les attributs (généralement des dimensions) selon lesquels vous souhaitez **grouper vos attributs [Data](#configurer-le-champ-data)** (généralement des mesures). ![Configure the field Scale — Visual scale1](/images/public-cloud/data-platform/product/am/queries/picts/visual-scale1.png) :::info Un exemple de cas d'usage est lorsque la requête doit renvoyer le montant du chiffre d'affaires par mois ou le montant du chiffre d'affaires par magasin. ::: Vous pouvez ajouter autant d'attributs que vous le souhaitez tant qu'ils existent dans la même table, sinon une erreur sera renvoyée. La liste des attributs disponibles dans l'interface est automatiquement filtrée pour n'afficher que les autres attributs disponibles. ## Configurer le champ Filter Ce paramètre est utilisé pour appliquer des filtres aux valeurs que la requête doit renvoyer. :::info Les filtres sont particulièrement utiles pour empêcher que des valeurs nulles ou non renseignées soient affichées ou prises en compte. ::: ![Configure the field Filter — Visual filter1](/images/public-cloud/data-platform/product/am/queries/picts/visual-filter1.png) Saisissez les valeurs de référence pour les filtres de **type chaîne de caractères** telles quelles, sans les _" "_ autour de la chaîne. Saisissez les valeurs de référence pour les filtres de **type numérique** également telles quelles. :::info Utilisez le panneau du widget _"See table details"_ à gauche de l'écran pour vérifier le type des attributs à utiliser comme filtres. ::: Voici la liste de toutes les options de filtre disponibles : - _Equal_ - la valeur est égale à la référence. - _Not equal_ - la valeur n'est pas égale à la référence. - _In_ - la valeur est contenue dans la liste de référence (appuyez sur Entrée pour ajouter une valeur à la liste). - _Not In_ - la valeur n'est pas contenue dans la liste de référence (appuyez sur Entrée pour ajouter une valeur à la liste). - _Greater than_ (>) - la valeur est supérieure à une référence. - _Greater than equal_ (>=) - la valeur est supérieure ou égale à une valeur de référence. - _Lower than_ (\<) - la valeur est inférieure à une valeur de référence. - _Lower than equal_ (\<=) - la valeur est inférieure ou égale à une valeur de référence. - _Between_ - la valeur est comprise entre 2 valeurs. - _Not between_ - la valeur n'est pas comprise entre 2 valeurs. - _Null_ - la valeur est nulle. - _Not null_ - la valeur n'est pas nulle. - _Like_ - la sous-chaîne de la valeur est contenue dans la valeur de référence (formatée selon la [syntaxe SQL LIKE](https://sql.sh/cours/where/like)). - _Not like_ - la sous-chaîne de la valeur n'est pas contenue dans une autre valeur de référence (formatée selon la [syntaxe SQL LIKE](https://sql.sh/cours/where/like)). ## Configurer le champ Order Ce paramètre est utilisé pour ordonner les résultats renvoyés par la requête en fonction de l'ordre des valeurs d'un ou plusieurs champs, par ordre croissant ou décroissant. ![Configure the field Order — Visual order1](/images/public-cloud/data-platform/product/am/queries/picts/visual-order1.png) :::info Les attributs du champ [Scale](#configurer-le-champ-scale) ne sont pas ajoutés au champ _Order_ par défaut, afin d'optimiser les temps d'exécution. ::: ## Découvrir le format de réponse Lorsqu'une requête est exécutée en mode visuel, les résultats sont renvoyés selon le format suivant. ```json [ { "scales": { "company": "Snapchat" }, "data": { "sales": { "avg": [ { "company": "Snapchat", "value": 494.96303030302937 } ] } } }, { "scales": { "company": "Pied Piper" }, "data": { "sales": { "avg": [ { "company": "Pied Piper", "value": 492.7505523255817 } ] } } }, { "scales": { "company": "Google" }, "data": { "sales": { "avg": [ { "company": "Google", "value": 501.16340892465297 } ] } } }, { "scales": { "company": "Facebook" }, "data": { "sales": { "avg": [ { "company": "Facebook", "value": 512.5209205642168 } ] } } } ] ``` Pour voir la réponse brute envoyée par l'Analytics Manager lorsque votre requête est exécutée, visualisez les résultats sous forme de tableau. Puis cliquez sur l'**icône d'engrenage** et activez _Display raw response_. ![Discover the response format — Visual raw response](/images/public-cloud/data-platform/product/am/queries/picts/visual-raw-response.png) Enfin, il est possible d'exporter les résultats de la requête dans différents formats (comme un .csv, en copiant des valeurs séparées par des tabulations, etc.) en cliquant sur le bouton **Download** à côté du bouton Run. ![Discover the response format — Export](/images/public-cloud/data-platform/product/am/queries/picts/export.png) ## Aller plus loin Si vous avez besoin d'une formation ou d'une assistance technique pour la mise en oeuvre de nos solutions, contactez votre commercial ou cliquez sur [ce lien](https://www.ovhcloud.com/fr/professional-services/) pour obtenir un devis et demander une analyse personnalisée de votre projet à nos experts de l’équipe Professional Services. Posez vos questions, faites-nous part de vos commentaires et interagissez directement avec l’équipe qui développe la Data Platform sur le [canal Discord](https://discord.gg/ovhcloud) dédié. Si vous avez besoin d'une assistance concernant vos services OVHcloud, créez une demande depuis notre [centre d'aide](https://help.ovhcloud.com/csm?id=csm_get_help). Rejoignez notre [communauté d'utilisateurs](https://community.ovhcloud.com/).