Хотите извлечь данные с вашего сайта Discourse, но не знаете, с чего начать? Вы попали по адресу! Это руководство tutorial для новичков, которые только знакомятся с Data Explorer. Если вы уже знакомы с SQL и тем, как использовать Data Explorer, скорее всего, вам не нужно читать эту тему, и вы можете перейти к нашей категории #data-reporting::category.
Хотите извлечь данные с вашего сайта Discourse, но не знаете, с чего начать? Вы попали по адресу! Это руководство Цель этого руководства — помочь вам получить базовое представление о том, как использовать Data Explorer для создания отчетов на вашем сайте Discourse. Это первая часть серии руководств по Data Explorer.
Что такое Data Explorer?
Data Explorer — это плагин для Discourse, который позволяет выполнять SQL-запросы к вашей базе данных и экспортировать результаты. Это мощный инструмент для извлечения и анализа данных с вашего сайта Discourse.
Прежде чем вы сможете использовать Data Explorer, вам нужно установить его на свой сайт. Если вам нужна помощь, ознакомьтесь со статьей Install plugins on a self-hosted site.
После установки Data Explorer вы сможете начать использовать его для выполнения SQL-запросов.
Создание нашего первого SQL-запроса
Лучший способ познакомиться с Data Explorer — получить практический опыт!
Давайте начнем с создания нашего первого запроса:
- Перейдите в административную панель вашего сайта и нажмите на вкладку
Plugins. - Найдите плагин
Data Explorerи нажмите на него. - Нажмите кнопку
+, чтобы открыть текстовое поле и кнопку для создания нового SQL-запроса. - Введите название вашего запроса.
- Нажмите
Create New, чтобы создать запрос.
Теперь мы можем начать строить наш первый запрос.
Страница по умолчанию для нового запроса:
Привет, мир
Для нашего первого запроса создадим отчет, который покажет: Самые просматриваемые темы на сайте 
Подумав о том, как нам это сделать, начнем с выбора полей title и views из таблицы topics:
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
Теперь названия тем отображаются как гиперссылки!
replies(ответов) в этой теме.
Добавление параметров и операторов 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-запросах, мы настоятельно рекомендуем прочитать другие темы в этой серии.