#Запит даних у режимі SQL

На панелі "Запит даних" перейдіть у режим 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;

#Перегляд результатів

• Натисніть "Переглянути дані", щоб відкрити панель попереднього перегляду результатів.

Дані підтримують пагінацію; ви можете перемикатися між режимами Table (Таблиця) та 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-запит та пов'язані налаштування в базі даних.
• Натисніть "Скасувати", щоб повернутися до останнього збереженого стану та відкинути поточні незбережені зміни.