Vous souhaitez extraire des données de votre site Discourse mais vous ne savez pas par où commencer ? Vous êtes au bon endroit ! Ceci est un guide tutorial pour les débutants qui découvrent Data Explorer. Si vous êtes déjà familier avec SQL et comment utiliser Data Explorer, alors vous n’aurez probablement pas besoin de lire ce sujet, et vous pourriez plutôt consulter notre catégorie Data & reporting.
Vous souhaitez extraire des données de votre site Discourse mais vous ne savez pas par où commencer ? Vous êtes au bon endroit ! Ceci est un guide L’objectif de ce guide est de vous aider à acquérir une compréhension de base de la manière d’utiliser Data Explorer pour créer des rapports sur votre site Discourse, et constitue la première partie de notre série de tutoriels sur Data Explorer.
Qu’est-ce que Data Explorer ?
Data Explorer est un plugin Discourse qui vous permet d’exécuter des requêtes SQL sur votre base de données et d’exporter les résultats. C’est un outil puissant pour extraire et analyser des données de votre site Discourse.
Avant de pouvoir utiliser Data Explorer, vous devrez l’installer sur votre site. Consultez Install plugins on a self-hosted site si vous avez besoin d’aide pour cela.
Une fois que vous avez installé Data Explorer, vous pouvez commencer à l’utiliser pour exécuter des requêtes SQL.
Création de notre première requête SQL
La meilleure façon de vous familiariser avec Data Explorer est de mettre la main à la pâte !
Commençons par créer notre première requête :
- Accédez à l’administration de votre site et cliquez sur l’onglet
Plugins. - Trouvez le plugin
Data Exploreret cliquez dessus. - Cliquez sur le bouton
+pour afficher une zone de texte et un bouton pour créer une nouvelle requête SQL. - Tapez le nom de votre requête.
- Cliquez sur
Create Newpour créer la requête.
À partir de là, nous pouvons commencer à construire notre première requête.
La page de nouvelle requête par défaut :
Hello World
Pour notre première requête, créons un rapport qui nous montrera : Les sujets les plus consultés sur le site 
En réfléchissant à la manière dont nous devrons créer cela, commençons par sélectionner les champs title et views de la table topics :
SELECT
title, views
FROM
topics
Ce qui nous montrera une liste de tous les sujets sur le site et le nombre de vues qu’ils ont. Cliquez sur Run pour voir cela en action :
Tri des résultats
En regardant ces résultats, vous remarquerez qu’ils ne sont pas ordonnés - c’est parce que nous devons explicitement utiliser une instruction ORDER BY pour trier nos résultats comme nous le souhaitons. Ajoutons cela maintenant :
SELECT
title, views
FROM
topics
ORDER BY views DESC
Cliquez à nouveau sur Run pour voir ce qui a changé :
Voilà - nos résultats sont maintenant triés par ordre descendant par vues !
Mise en forme des résultats
Avec cette requête, ne serait-il pas agréable de pouvoir cliquer directement sur le nom du sujet et d’être redirigé vers le sujet ? Heureusement, nous pouvons le faire avec les Formatted Table Results !
Changeons la section title de notre requête en id as topic_id pour voir cela en action :
SELECT
id as topic_id,
views
FROM
topics
ORDER BY views DESC
Maintenant, les titres des sujets sont affichés sous forme de liens hypertextes !
réponsesque le sujet a.
Ajout de paramètres et de déclarations WHERE
Pour notre dernière addition à la requête, modifions la requête afin de n’afficher que les sujets avec plus de X vues. Pour ce faire, nous devrons ajouter un paramètre et une instruction WHERE. Pour notre paramètre, nous utiliserons un int (entier), et l’instruction WHERE filtrera les résultats de sorte que seuls les sujets ayant plus du nombre minimum de vues soient affichés.
-- [params]
-- int :min_views= 10
SELECT
id as topic_id,
views
FROM
topics
WHERE views > :min_views
ORDER BY views DESC
Lorsque vous exécuterez cette requête, vous verrez maintenant qu’il existe un paramètre min_views que vous pouvez utiliser pour modifier le nombre minimum de vues que les sujets doivent avoir pour être affichés dans les résultats.
Conclusion
Nous espérons que vous commencez à avoir une idée de la façon dont les requêtes Data Explorer sont construites après avoir suivi ces étapes, cependant, nous n’avons fait qu’effleurer la surface dans ce sujet !
Data Explorer, et plus généralement, SQL est un sujet très, très vaste. Si vous souhaitez en savoir plus sur Data Explorer et les requêtes SQL, nous vous recommandons vivement de lire les autres sujets de cette série.