#Запрос данных

Панель конфигурации графика разделена на три секции: «Запрос данных», «Параметры графика» и «События взаимодействия», а также содержит кнопки «Отмена», «Предпросмотр» и «Сохранить» внизу.

Сначала рассмотрим панель «Запрос данных», чтобы понять два режима запроса (Конструктор/SQL) и их общие возможности.

#Структура панели

Подсказка: чтобы проще настраивать текущий контент, можно сначала свернуть другие панели.

Сверху находится панель действий:

• Режим: Конструктор (графический, простой и удобный) / SQL (ручные запросы, более гибкий).
• Выполнить запрос: нажмите, чтобы выполнить запрос данных.
• Просмотр результата: открывает панель результата данных, где можно переключаться между Таблица/JSON. Повторный клик сворачивает панель.

Сверху вниз:

• Источник данных и коллекция: обязательно. Выберите источник данных и коллекцию.
• Показатели: обязательно. Числовые поля, которые нужно отобразить.
• Измерения: поля группировки (например, дата, категория, регион).
• Фильтр: настройка условий фильтрации (например, равно, не равно, больше, меньше, содержит, диапазон). Можно объединять несколько условий.
• Сортировка: выбор поля сортировки и порядка (по возрастанию/по убыванию).
• Пагинация: контроль диапазона данных и порядка возврата.

#Режим Конструктор

#Выбор источника данных и коллекции

• В панели «Запрос данных» установите режим «Конструктор».
• Выберите источник данных и коллекцию. Если коллекция недоступна для выбора или пуста, сначала проверьте права и факт её создания.

#Настройка показателей

• Выберите одно или несколько числовых полей и задайте агрегацию: Сумма, Количество, Среднее, Максимум, Минимум.
• Типичные сценарии: Количество для подсчёта записей, Сумма для вычисления суммарного значения.

#Настройка измерений

• Выберите одно или несколько полей как измерения для группировки.
• Для полей даты и времени можно задать формат (например, YYYY-MM, YYYY-MM-DD) для удобной группировки по месяцам или дням.

#Фильтр, сортировка и пагинация

• Фильтр: добавьте условия (например, равно, не равно, содержит, диапазон). Можно объединять несколько условий.
• Сортировка: выберите поле и порядок сортировки (по возрастанию/по убыванию).
• Пагинация: задайте Ограничение и Смещение для контроля количества возвращаемых строк. При отладке рекомендуется устанавливать небольшое Ограничение.

#Выполнение запроса и просмотр результата

• Нажмите «Выполнить запрос». После получения ответа переключайтесь между Таблица / JSON в «Просмотр результата», чтобы проверить колонки и значения.
• Перед сопоставлением полей графика проверьте здесь имена колонок и типы, чтобы избежать пустого графика и ошибок на следующих шагах.

#Последующее сопоставление полей

Позже, при настройке «Параметры графика», вы будете сопоставлять поля на основе полей выбранного источника данных и коллекции.

#Режим SQL

#Написание запроса

• Переключитесь в режим «SQL», введите запрос и нажмите «Выполнить запрос».
• Пример (сумма заказов по датам):

SELECT 
  TO_CHAR(order_date, 'YYYY-MM') as mon,
  SUM(total_amount) AS total
FROM "order"
GROUP BY mon
ORDER BY mon ASC
LIMIT 100;

#Выполнение запроса и просмотр результата

• Нажмите «Выполнить запрос». После получения ответа переключайтесь между Таблица / JSON в «Просмотр результата», чтобы проверить колонки и значения.
• Перед сопоставлением полей графика проверьте здесь имена колонок и типы, чтобы избежать пустого графика и ошибок на следующих шагах.

#Последующее сопоставление полей

Позже, при настройке «Параметры графика», вы будете сопоставлять поля на основе колонок из результата запроса.