2026-05-18 · Чтение 1 мин
SQL-форматтер в code review
Единообразные SQL-diff уменьшают шум и быстрее показывают изменения логики.
Основные выводы
- Согласуйте dialect с движком (PostgreSQL, MySQL, SQLite) перед форматированием.
- Перечитайте JOIN и WHERE после форматирования — изменения структуры не должны скрывать правки логики.
Почему это важно ревьюерам
Неформатированный SQL заставляет ревьюеров мысленно разбирать ключевые слова, скрывая случайные cartesian products или пропущенные predicates.
Отформатированный запрос делает границы CTE и шаги агрегации обозримыми за секунды.
Явно выберите dialect
Укажите dialect во вторичном поле, если команда использует PostgreSQL vs MySQL — регистр и имена функций различаются.
После форматирования вставьте в SQL-клиент и убедитесь, что plan не изменился неожиданно.
Часто задаваемые вопросы
Форматирование сломает запрос?
Семантика должна сохраниться; для чувствительных к производительности запросов запустите EXPLAIN на staging.
Можно форматировать хранимые процедуры?
Да, для читаемости, но сначала протестируйте выполнение на непродакшен-БД.