想要从您的 Discourse 站点提取一些数据，但不知道从何开始？您来对地方了！这是一份针对初学者的 tutorial 指南，他们刚接触 Data Explorer。如果您已经熟悉 SQL 以及如何使用 Data Explorer，那么您很可能不需要阅读这些主题，而是可以查看我们的 Data & reporting 类别。
想要从您的 Discourse 站点提取一些数据，但不知道从何开始？您来对地方了！这是一份针对初学者的 本指南的目的是帮助您基本掌握如何使用 Data Explorer 为您的 Discourse 站点创建报告，这是我们的 Data Explorer 教程系列的第一部分。
什么是 Data Explorer？
Data Explorer 是一个 Discourse 插件，允许您针对数据库运行 SQL 查询并导出结果。它是从 Discourse 站点提取和分析数据的强大工具。
在使用 Data Explorer 之前，您需要先在您的站点上安装它。如果您需要任何帮助，请参阅 https://meta.discourse.org/t/install-plugins-in-discourse/19157。
安装 Data Explorer 后，您就可以开始使用它来运行 SQL 查询了。
创建我们的第一个 SQL 查询
熟悉 Data Explorer 的最佳方法是获得一些实践经验！
让我们开始创建第一个查询：
- 前往您站点的管理员页面，然后点击
Plugins（插件）选项卡。 - 找到
Data Explorer（数据探索器）插件并点击它。 - 点击
+按钮，将看到一个用于创建新 SQL 查询的文本框和按钮。 - 输入查询的名称。
- 点击
Create New（创建新）以创建查询。
从这里我们可以开始构建我们的第一个查询。
默认的新查询页面：
Hello World
作为我们的第一个查询，让我们创建一个报告，显示：网站上浏览量最多的主题 
考虑到我们需要如何创建这个报告，让我们从 topics 表中选择 title（标题）和 views（浏览量）字段开始：
SELECT
title, views
FROM
topics
这将向我们显示网站上所有主题的列表以及它们的浏览量。点击 Run（运行）查看效果：
对结果进行排序
查看这些结果，您会发现它们没有排序——这是因为我们需要显式使用 ORDER BY 语句来按所需方式对结果进行排序。现在让我们添加它：
SELECT
title, views
FROM
topics
ORDER BY views DESC
再次点击 Run（运行）查看发生了什么变化：
好了——我们的结果现在按浏览量 降序 排列了！
格式化结果
有了这个查询，如果我们能够直接点击主题的名称并跳转到该主题，那不是很棒吗？幸运的是，我们可以通过格式化表格结果来实现这一点！
让我们将查询的 title 部分更改为 id as topic_id 来查看效果：
SELECT
id as topic_id,
views
FROM
topics
ORDER BY views DESC
现在主题的标题显示为超链接了！
回复数量。
添加参数和 WHERE 语句
作为我们对查询的最后一次添加，让我们修改查询，以便我们只查看浏览量超过 X 数量的主题。为此，我们需要添加一个参数和一个 WHERE 语句。对于我们的参数，我们将使用 int（整数），而 WHERE 语句将过滤结果，以便只显示浏览量超过最小数量的主题。
-- [params]
-- int :min_views= 10
SELECT
id as topic_id,
views
FROM
topics
WHERE views > :min_views
ORDER BY views DESC
运行此查询时，您现在会看到有一个 min_views 参数，您可以使用它来更改主题在结果中显示所需的最小浏览量。
总结
希望您在完成这些步骤后已经对 Data Explorer 查询的构建方式有了一些想法，但是，我们在本主题中仅仅触及了皮毛！
Data Explorer 以及更广泛的 SQL 是一个非常非常广泛的主题。如果您有兴趣了解更多关于 Data Explorer 和 SQL 查询的信息，我们强烈建议您阅读本系列的其他主题。