#Запрос данных в режиме SQL

В панели «Запрос данных» переключитесь в режим SQL, напишите и выполните запрос, а затем используйте полученные результаты напрямую для построения и отображения диаграмм.

#Написание SQL-запросов

• В панели «Запрос данных» выберите режим SQL.
• Введите SQL-запрос и нажмите «Выполнить запрос».
• Поддерживаются сложные запросы, включая многотабличные JOIN и VIEW.

Пример: сумма заказа по месяцам

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», чтобы проверить имена и типы столбцов.

#Сопоставление полей

• В настройках «Параметры диаграммы» сопоставьте поля на основе столбцов результатов запроса.
• По умолчанию первый столбец используется как измерение (ось X или категория), а второй — как показатель (ось Y или значение). Поэтому обратите внимание на порядок столбцов в SQL-запросе:

SELECT 
  TO_CHAR(order_date, 'YYYY-MM') as mon, -- поле измерения в первом столбце
  SUM(total_amount) AS total -- поле показателя далее

#Использование контекстных переменных

Нажмите кнопку x в правом верхнем углу SQL-редактора, чтобы выбрать контекстные переменные.

После подтверждения выражение переменной будет вставлено в позицию курсора (или заменит выделенный текст) в SQL-запросе.

Например, {{ ctx.user.createdAt }}. Обратите внимание, что не нужно добавлять дополнительные кавычки.

#Дополнительные примеры

Дополнительные примеры использования вы можете найти в демо-приложении NocoBase.

Рекомендации:

• Стабилизируйте имена столбцов перед сопоставлением с диаграммами, чтобы избежать ошибок в дальнейшем.
• На этапе отладки используйте LIMIT для уменьшения количества возвращаемых строк и ускорения предварительного просмотра.

#Предварительный просмотр, сохранение и откат

• Нажмите «Выполнить запрос», чтобы запросить данные и обновить предварительный просмотр диаграммы.
• Нажмите «Сохранить», чтобы сохранить текущий SQL-запрос и связанные с ним настройки в базу данных.
• Нажмите «Отмена», чтобы вернуться к последнему сохраненному состоянию и отменить текущие несохраненные изменения.