Как проверить SQL, который написал агент

Агент пишет SQL быстро и уверенно. Запрос выполняется, таблица с цифрами появляется. Но неверный SQL почти никогда не падает с ошибкой. Он просто возвращает другие числа.

У кода есть тесты, типы и компилятор. У отчёта, который агент собрал по вашей просьбе, обычно нет ничего: число в ячейке выглядит одинаково убедительно, верное оно или завышено втрое. Поэтому проверять приходится сам запрос. Чаще всего ошибка встречается в пяти местах.

1. JOIN, который размножил строки

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

SELECT SUM(o.amount) AS revenue
FROM orders o
JOIN order_items i ON i.order_id = o.id
WHERE o.created_at >= '2026-10-01';

Сумма заказа o.amount лежит в таблице заказов, но после соединения заказ с тремя позициями встречается три раза11Аналитики называют это fan-out: соединение «один ко многим» увеличивает число строк на стороне «один». Быстрая проверка — сравнить COUNT(*) и COUNT(DISTINCT o.id): если они расходятся, строки размножились. — и его сумма складывается трижды. Запрос выглядит разумно, выполняется без ошибок и возвращает правдоподобное число.

Лечится по-разному. Если позиции для ответа не нужны, соединение просто убирают. Если нужны — сначала агрегируют подробную таблицу до одной строки на заказ в подзапросе или CTE, а потом присоединяют результат. Полезно для каждой таблицы знать её зерно: что означает одна строка. «Одна строка — один заказ» и «одна строка — одна позиция заказа» складывать напрямую нельзя.

2. LEFT JOIN, который стал обычным

LEFT JOIN оставляет строки без пары. Но стоит добавить в WHERE условие на правую таблицу — и строки без пары исчезнут, будто соединение обычное. Условия на присоединённую таблицу обычно должны стоять в ON.

SELECT u.id, COUNT(o.id) AS orders_in_october
FROM users u
LEFT JOIN orders o ON o.user_id = u.id
WHERE o.created_at >= '2026-10-01'
GROUP BY u.id;

Задумано: все пользователи и число их заказов за октябрь, у кого заказов нет — ноль. Получилось: только пользователи с заказами в октябре. У остальных в колонке o.created_at стоит NULL, условие в WHERE22Для обычного INNER JOIN условие в ON и в WHERE даёт одинаковый результат. Отсюда и привычка писать все фильтры в WHERE, которая ломает именно внешние соединения. для них не выполняется, и строки отбрасываются. Нулей в отчёте не будет вовсе — а именно ради них и писали LEFT JOIN.

Исправление — перенести условие в соединение: LEFT JOIN orders o ON o.user_id = u.id AND o.created_at >= '2026-10-01'.

3. NULL, который выпал из подсчёта

COUNT(column) не считает пустые значения, AVG их пропускает, а WHERE status != 'paid' не вернёт строки, где статус пустой33Для проверки NULL используют IS NULL и IS NOT NULL. Обычное сравнение с NULL тоже даёт неопределённый результат. Примеры в PostgreSQL.. Для каждой такой колонки нужно решить, что значит пустота и должна ли она попасть в результат.

Средний чек, посчитанный через AVG(amount), — это среднее по заказам, у которых сумма заполнена. Если у отменённых заказов сумма пустая, они в среднее не войдут. Если она равна нулю — войдут и потянут его вниз. Какой из вариантов нужен отчёту, решает человек, а не случай. Явное решение записывают через COALESCE(amount, 0) или через фильтр.

Самый неприятный случай — NOT IN с подзапросом:

SELECT * FROM users
WHERE id NOT IN (SELECT user_id FROM orders);

Если в orders.user_id есть хотя бы один NULL, запрос не вернёт ни одной строки44В документации PostgreSQL это описано прямо: если совпадений нет, но в подзапросе встретился NULL, результат NOT IN — не истина, а NULL. Надёжная замена — NOT EXISTS.. Не ошибку, не предупреждение — пустой результат, который легко принять за «таких пользователей нет».

4. Группировка не по тому полю

Отчёт по дням, сгруппированный по полной дате со временем, даст строку на каждую секунду. Отчёт по клиентам, сгруппированный по имени, склеит двух разных Ивановых. Группируйте по ключам, а подписи добавляйте после.

Для дат это значит сначала привести время к нужной единице55Граница дня зависит от часового пояса. Заказ, сделанный в 01:30 по Москве, по UTC относится ещё ко вчерашнему числу. Если база хранит время в UTC, а отчёт нужен по местному времени, пояс указывают в запросе явно.: created_at::date или date_trunc('month', created_at) в PostgreSQL. Для клиентов, товаров и городов — группировать по идентификатору, а имя выводить рядом.

Отдельный признак беды — DISTINCT, который агент добавил «на всякий случай». Обычно он появляется, когда в результате обнаружились дубли, и вместо поиска причины их просто убрали. Причина при этом осталась: чаще всего это соединение из первого пункта, и суммы по-прежнему считаются по размноженным строкам.

5. Изменение без транзакции и без WHERE

UPDATE или DELETE, который агент предлагает «быстро поправить», сначала запустите как SELECT с тем же условием и посмотрите, сколько строк он заденет. Изменение данных — в транзакции, изменение схемы — миграцией, а не руками в проде.

SELECT COUNT(*) FROM orders
WHERE status = 'new' AND created_at < '2026-01-01';   -- 1240

BEGIN;
UPDATE orders SET status = 'cancelled'
WHERE status = 'new' AND created_at < '2026-01-01';   -- UPDATE 1240
COMMIT;   -- или ROLLBACK, если число не сошлось

База сама сообщает, сколько строк изменила. Если ждали тысячу, а получили сорок тысяч — ROLLBACK66В PostgreSQL в транзакцию можно обернуть и изменение схемы: неудачный ALTER TABLE откатится. В MySQL такие команды завершают транзакцию неявно, и ROLLBACK их не отменит., и ничего не произошло. Без BEGIN та же команда применяется сразу, и откатывать её придётся из резервной копии.

Агенту, который работает с базой сам, а не через вас, лучше не давать возможности ошибиться: отдельная роль только с правом чтения, по возможности на реплике, и ограничение времени запроса. Тогда худшее, что он может сделать, — получить неверную цифру, а не изменить данные.

Что ещё посмотреть, если есть минута

Доли и проценты. Конверсия, посчитанная как деление одного COUNT на другой, в PostgreSQL часто равна нулю: оба операнда целые, и дробная часть отбрасывается77В PostgreSQL 5 / 10 вернёт 0, а не 0,5. Чтобы получить долю, один из операндов приводят к дробному типу: COUNT(a)::numeric / COUNT(b). Математические операторы.. Запрос при этом выглядит верно, а в отчёте стоит столбец нулей, который легко принять за «конверсии нет».

LIMIT без ORDER BY. «Топ-10 клиентов» без сортировки — это десять произвольных клиентов. Порядок строк без ORDER BY база не гарантирует, и завтра тот же запрос может вернуть других.

Границы периода. created_at <= '2026-10-31' для колонки со временем означает «до полуночи, с которой начинается 31 октября» — весь последний день месяца выпадает. Надёжнее полуоткрытый интервал: >= '2026-10-01' AND < '2026-11-01'.

Тяжёлый запрос. Прежде чем запускать на рабочей базе запрос, который читает большую таблицу целиком, посмотрите его план88EXPLAIN показывает план, не выполняя запрос. EXPLAIN ANALYZE запрос выполняет на самом деле: для UPDATE и DELETE его оборачивают в BEGIN и ROLLBACK. Так советует и документация.: пойдёт ли база по индексу или будет перебирать все строки подряд. Агент этого не проверяет, если его не попросить, а запрос на минуту в рабочее время замечают все.

Как помочь агенту ошибаться реже

Большая часть этих ошибок — не небрежность, а нехватка сведений. Агент видит имена таблиц и колонок, но не знает, что в payments бывает несколько строк на заказ, что status у старых записей пустой, а время хранится в UTC.

Дайте ему это заранее: схему, зерно каждой таблицы в одну строку, смысл пустых значений в важных колонках и часовой пояс. Попросите вместе с запросом перечислить допущения, которые он сделал, — в этом списке ошибка обычно видна раньше, чем в самом SQL. И попросите проверочный запрос: число строк до и после соединения, сумму по известному периоду.

Если запросов много, эти сведения стоит один раз записать в файл рядом со схемой и сослаться на него из правил проекта. Тогда их не придётся повторять в каждом сеансе, а новая находка — «в этой таблице бывают дубли» — попадёт туда же и сработает в следующий раз.

Привычка, которая ловит почти всё

Перед тем как поверить отчёту, сверьте его с чем-то, что знаете наверняка: число заказов за вчера, выручку за прошлый месяц из бухгалтерии, количество клиентов в админке. Если сходится на известном — можно смотреть на неизвестное.

Всё это — от JOIN и NULL до транзакций, индексов и безопасной работы агента с базой — разбираем на курсе «Основы SQL»: запросы запускаются прямо в уроке, на учебной базе.

Курсы по теме

У каждого курса есть бесплатная часть: оставьте почту и начните сразу.

Рассылка

Раз в месяц — новые курсы, обновления программ и платформы. Отписаться можно в один клик из любого письма.

Начните учиться сегодня

Все курсы за 1500 ₽ в месяц. Доступ откроется сразу после оплаты, отменить можно в любой момент.

Для компаний — 5000 ₽ в месяц за сотрудника