Эта страница — каноническое руководство по форматированию и minify SQL в Dev Tools Suite. Используйте интерактивный SQL Formatter выше во время чтения или перейдите к разделу ниже. Весь разбор и форматирование выполняются в браузере через sql-formatter — запросы, имена схем и примеры данных никогда не загружаются на сервер.

SQL Formatter украшает многострочный SQL для людей и minify для передачи. Автоматически переводит ключевые слова в верхний регистр (SELECT, FROM, WHERE), применяет отступы по предложениям и соблюдает грамматику диалекта библиотеки sql-formatter — тот же движок, что у многих IDE-расширений и CLI-форматтеров.

Что вы получаете

• Симметричная двухпанельная область: SQL-запрос слева, отформатированный или minify вывод справа
• 13 парсеров диалектов: ядро реляционных, облачные хранилища, big data, enterprise
• Режимы Beautify и Minify с живым автоформатом (debounce) и явной кнопкой Process
• Выбор диалекта и Strip comments в заголовке панели — без лишней строки
• Сворачиваемый отформатированный вывод для больших деревьев SELECT (Beautify)
• Ошибки разбора с подсказками строки и столбца, когда парсер не читает ввод
• Опциональный URL: ?mode=minify&dialect=postgresql сохраняет режим и диалект

Используйте инструмент, когда

• Вставляете ad-hoc SQL из лога, BI или ORM и нужны читаемые отступы перед ревью
• Встраиваете SQL в код приложения и нужна однострочная minify-строка
• Работаете с PostgreSQL, Snowflake, BigQuery, Spark или Oracle и нужно распознавание ключевых слов диалекта
• Нужно удалить блочные и строчные комментарии перед коммитом или отправкой

Не ожидайте

• Семантическая валидация — успех форматирования не гарантирует выполнение на сервере
• Автопланирование запросов, lint производительности или переписывание с учётом схемы
• Идеальное сохранение каждого экзотического расширения вне выбранного диалекта
• Серверный EXPLAIN или выполнение — только инструмент разметки и пробелов

Элементы управления в заголовке панели SQL QUERY, чтобы редакторы ввода и вывода были одной высоты. Отдельной строки опций под панелью инструментов нет.

Сочетания клавиш

• Ctrl/Cmd+Enter — Process
• Ctrl/Cmd+L — Очистить рабочую область

Всегда выбирайте диалект среды выполнения. Парсер использует разные списки ключевых слов, имён функций и правил комментариев. Standard SQL — безопасный выбор для общих ANSI-фрагментов.

Cassandra CQL не поддерживается — не входит в набор диалектов sql-formatter. Для Cassandra используйте CQL-форматтер.

Beautify и Minify делят выбор диалекта и Strip comments, но дают разную форму вывода.

Пример

Ввод: select id, name from users where active = 1 — Beautify даёт строки с отступами и SELECT/FROM/WHERE в верхнем регистре. Minify с выключенным Strip — одна строка: select id, name from users where active = 1.

1. Откройте SQL Formatter в боковой панели Formatters.
2. Вставьте SQL слева, загрузите .sql с панели сессии или перетащите файл на пустое состояние.
3. Выберите диалект БД (напр. snowflake для листа Snowflake).
4. При необходимости включите Strip comments для нежелательных -- или /* */.
5. Beautify для читаемого SQL или Minify для компактной строки.
6. Проверьте вывод справа. Исправьте баннер ошибки разбора — закройте после правки.
7. Копируйте, скачивайте или меняйте вывод с вводом для повторного прохода.
8. Делитесь ссылкой ?dialect=bigquery&mode=minify для тех же настроек.

Файлы миграций Flyway, Liquibase и ORM проще ревьюить, когда списки SELECT, JOIN и WHERE разбиты на согласованные строки.

Рабочий процесс

1. Установите диалект postgresql, transactsql, mysql или sqlite под цель миграции.
2. Вставьте сырой SQL миграции из diff или вывода ORM.
3. Beautify с выключенным Strip, если строчные комментарии документируют намерение.
4. Скопируйте отформатированный SQL в файл миграции перед PR.

Совет

Форматирование не валидирует live-схему. Запускайте миграции на staging после косметических правок.

Аналитики часто копируют SQL из консолей Snowflake, BigQuery или Redshift с несогласованным регистром и сжатыми строками.

Snowflake / BigQuery / Redshift

• Выберите snowflake, bigquery или redshift перед Beautify для корректного разбора функций хранилища.
• Используйте Strip comments при экспорте из блокнота с -- заметками сессии.
• Для очень широких SELECT после Beautify используйте Expand all / Collapse all.

Spark / Trino / Hive

• spark для Databricks и Spark SQL.
• trino для федеративных Presto-совместимых запросов по каталогам.
• hive для унаследованного HiveQL — покрытие по правилам Hive sql-formatter.

Код приложения часто хранит SQL как шаблонную строку. Minify уменьшает байты и экранирование для одной строки в JavaScript, Python или Go.

1. Вставьте читаемый SQL во входную панель.
2. Включите Strip comments, если остались отладочные заметки.
3. Переключитесь на Minify.
4. Скопируйте однострочный вывод в строковый литерал (следите за кавычками).

Если в исходнике нужен читаемый SQL, а в runtime компактный — beautify в документации, minify только артефакта сборки.

Нормализуйте SQL перед ревью, чтобы diff показывал логику, а не шум пробелов.

• Beautify обе стороны сравнения, если коллега вставил однострочный SQL в тикет.
• Верхний регистр ключевых слов как единый стиль — Beautify применяет автоматически.
• После форматирования двух версий направьте вывод в Text Diff для семантического diff текста запроса.

Strip comments действует в Beautify и Minify. При включении инструмент удаляет комментарии до форматирования по правилам диалекта, где реализовано.

Когда Strip выключен (Minify)

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

При сбое парсера красный баннер показывает Parse error со строкой и столбцом. Редактор ввода подсвечивает строку ошибки, если доступно.

Типичные исправления

1. Неверный диалект — переключитесь на реальный движок (plsql для Oracle, не Standard SQL).
2. Незакрытая строка или скобка — уравняйте кавычки и скобки у указанной строки.
3. Хвостовая запятая или незавершённое предложение — завершите SELECT и CTE.
4. Вставлен не-SQL — уберите оболочку shell или JSON вокруг запроса.
5. Синтаксис диалекта в общем режиме — попробуйте vendor-диалект или упростите неподдерживаемые расширения.

Если валидный запрос всё ещё падает, парсер sql-formatter может не покрывать вариант синтаксиса. Сообщите upstream или отформатируйте упрощённое подмножество вручную.

SQL Formatter работает на 100 % в браузере. Библиотека sql-formatter загружается динамически; форматирование в главном потоке JavaScript.

• Текст запросов не отправляется на серверы Dev Tools Suite
• Ввод, вывод, диалект и Strip comments могут храниться в localStorage на устройстве
• URL-параметры (?dialect=, ?mode=) только отражают настройки — без тела SQL
• Очищайте область (Ctrl/Cmd+L) после работы с продакшен-данными или PII

• Сопоставьте диалект со средой выполнения перед Beautify — успех форматирования ≠ успех runtime
• Beautify для людей, Minify для машин
• Strip выключен, когда комментарии — бизнес-правила; включён для экспорта и встроенных строк
• Проверяйте minify на staging при dollar-quotes и экзотических литералах
• Для больших скриптов — история сессии и загрузка файла, не чат-приложения, меняющие кавычки
• С Text Diff при сравнении двух отформатированных версий одного отчётного запроса