#Запрос данных в 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-редактора, чтобы выбрать контекстные переменные.

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

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

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

Больше примеров смотрите в Demo app NocoBase.

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

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

#Предпросмотр, сохранение и откат

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