Tableaux de bord

La fonctionnalité de tableaux de bord de SQL Console vous permet de regrouper et de partager des visualisations à partir de requêtes enregistrées.

La fonctionnalité de tableaux de bord de la SQL Console vous permet de rassembler et de partager des visualisations issues de requêtes enregistrées. Pour commencer, enregistrez et visualisez des requêtes, ajoutez des visualisations de requêtes à un tableau de bord, puis rendez le tableau de bord interactif à l’aide de paramètres de requête.

​

Concepts fondamentaux

​

Partage de requêtes

Pour partager votre tableau de bord avec vos collègues, veillez également à partager la requête enregistrée d’origine. Pour afficher une visualisation, vous devez disposer au minimum d’un accès en lecture seule à la requête enregistrée d’origine.

​

Interactivité

Utilisez des paramètres de requête pour rendre votre tableau de bord interactif. Par exemple, vous pouvez ajouter un paramètre de requête à une clause WHERE pour qu’il serve de filtre.

Vous pouvez afficher ou masquer le champ de saisie du paramètre de requête depuis le volet latéral des filtres Global en sélectionnant le type « filter » dans les paramètres de visualisation. Vous pouvez également afficher ou masquer le champ de saisie du paramètre de requête en le liant à un autre objet (comme une table) du tableau de bord. Veuillez consulter la section « configurer un filtre » du guide de démarrage rapide ci-dessous.

​

Prise en main rapide

Créons un tableau de bord pour surveiller notre service ClickHouse à l’aide de la table système query_log.

​

Prise en main rapide

​

Créer une requête enregistrée

Si vous avez déjà des requêtes enregistrées que vous souhaitez visualiser, vous pouvez ignorer cette étape.

Ouvrez un nouvel onglet de requête. Rédigeons une requête pour compter le volume de requêtes par jour pour un service à l’aide des tables système de ClickHouse :

Nous pouvons afficher les résultats de la requête sous forme de tableau ou commencer à créer des visualisations depuis la vue graphique. Pour l’étape suivante, enregistrons la requête sous le nom queries over time :

Vous trouverez plus d’informations sur les requêtes enregistrées dans la section Saving a Query.

Nous pouvons créer et enregistrer une autre requête, query count by query kind, pour compter le nombre de requêtes selon leur type. Voici une visualisation en graphique à barres des données dans le SQL Console.

Maintenant que nous avons deux requêtes, créons un tableau de bord pour les visualiser et les regrouper.

​

Créer un tableau de bord

Accédez au panneau Tableaux de bord, puis cliquez sur « New Dashboard ». Une fois que vous lui avez attribué un nom, votre premier tableau de bord est créé !

​

Ajouter une visualisation

Deux requêtes enregistrées sont disponibles, queries over time et query count by query kind. Visualisons la première sous forme de graphique en courbes. Donnez un titre et un sous-titre à votre visualisation, puis sélectionnez la requête à afficher. Ensuite, sélectionnez le type de graphique « Line » et définissez les axes x et y.

Ici, vous pouvez également ajuster le style, par exemple le formatage des nombres, la disposition de la légende et les libellés des axes.

Ensuite, visualisons la deuxième requête sous forme de tableau et plaçons-la sous le graphique en courbes.

Vous avez créé votre premier tableau de bord en visualisant deux requêtes enregistrées !

​

Configurer un filtre

Rendons ce tableau de bord interactif en ajoutant un filtre sur le type de requête, afin de n’afficher que les tendances liées aux requêtes Insert. Pour cela, nous utiliserons les paramètres de requête.

Cliquez sur les trois points à côté du graphique en courbes, puis sur l’icône en forme de crayon à côté de la requête pour ouvrir l’éditeur de requête intégré. Vous pouvez alors modifier directement depuis le tableau de bord la requête enregistrée d’origine.

Une fois que vous aurez cliqué sur le bouton jaune d’exécution de la requête, vous verrez la même requête que précédemment, filtrée uniquement sur les requêtes insert. Cliquez sur le bouton d’enregistrement pour mettre à jour la requête. Lorsque vous reviendrez aux paramètres du graphique, vous pourrez filtrer le graphique en courbes.

À présent, à l’aide des filtres Global dans la barre supérieure, vous pouvez activer ou désactiver le filtre en modifiant la valeur d’entrée.

Supposons que vous souhaitiez lier le filtre du graphique en courbes au tableau. Pour cela, revenez aux paramètres de visualisation, remplacez par un tableau la source de valeur du paramètre de requête query_kind, puis sélectionnez la colonne query_kind comme champ à lier.

Vous pouvez maintenant contrôler le filtre du graphique en courbes directement depuis le tableau des requêtes par type, afin de rendre votre tableau de bord interactif.