// бесплатный инструмент

Форматтер MySQL

Форматируйте запросы MySQL и MariaDB в браузере. Обратные кавычки, комментарии #, переменные @ и операторы JSON читаются так, как это делает MySQL, и ничего из того, что вы вставляете, не загружается.

Перетащите сюда файл .sql, чтобы открыть его. Он читается в вашем браузере, а не загружается.

Отформатированный SQL
# monthly revenue by channel
SELECT
    DATE_FORMAT(o.`created_at`, '%Y-%m') AS `month`,
    o.meta ->> '$.channel' AS channel,
    SUM(oi.`qty` * oi.`price`) AS revenue
FROM
    `orders` o
    JOIN `order_items` oi ON oi.`order_id` = o.`id`
WHERE
    o.`status` = "paid"
    AND o.`customer_id` <=> @customer
GROUP BY
    `month`,
    channel
ORDER BY
    `month` DESC
LIMIT 12;

Loading the formatter…

Сочетания клавиш в редакторе: Ctrl+Enter форматы и Ctrl+Shift+Enter минифицирует (⌘ вместо Ctrl на Mac). Настройки запоминаются в этом браузере и хранятся в адресе страницы, поэтому ссылка делится вашим стилем – но не вашим SQL.

Что делает форматировщик с диалектом MySQL

  • Обратные кавычки и строки. `order` — это имя в кавычках, и "paid" — это строка, как в стандартном SQL-режиме MySQL. Всегда заключать в кавычки добавляет обратные кавычки.
  • Каждый стиль комментария сохраняется. # комментарии, -- комментарии и /*! … */ выполняемые комментарии остаются там, где вы их написали. MySQL требует пробела после --, и форматировщик следует тому же правилу.
  • Переменные — это имена. @rank пользовательские переменные, @@sql_mode системные переменные и := присваивания читаются как одиночные токены.
  • Операторы JSON и null-safe остаются целыми. ->, ->> и <=> никогда не делятся на - >> или <= >, что больше не будет работать.
  • Литералы сохраняют свой префикс. b'0101', x'ff', N'…' и интродьюсеры набора символов, такие как _utf8mb4'…' остаются прикрепленными, поэтому их никогда не читают как столбец с псевдонимом.
  • Кавычки с учетом регистра. Имена таблиц могут быть чувствительными к регистру в Linux, поэтому Удалить ненужные кавычки снимает кавычки только с имен в нижнем регистре.

Полезно знать

  • По умолчанию MySQL не допускает пробел между встроенными функциями, такими как COUNT или SUM и их скобками. Форматтер пишет COUNT(*) и Minify сохраняет вызовы так, как вы их написали; включайте Пробел перед скобками функции если ваш сервер работает с IGNORE_SPACE.

Примеры

MySQL до и после

До
# monthly revenue by channel
select date_format(o.`created_at`,'%Y-%m') as `month`,o.meta->>'$.channel' as channel,sum(oi.`qty`*oi.`price`) as revenue from `orders` o join `order_items` oi on oi.`order_id`=o.`id` where o.`status`="paid" and o.`customer_id`<=>@customer group by `month`,channel order by `month` desc limit 12;
После
# monthly revenue by channel
SELECT
    DATE_FORMAT(o.`created_at`, '%Y-%m') AS `month`,
    o.meta ->> '$.channel' AS channel,
    SUM(oi.`qty` * oi.`price`) AS revenue
FROM
    `orders` o
    JOIN `order_items` oi ON oi.`order_id` = o.`id`
WHERE
    o.`status` = "paid"
    AND o.`customer_id` <=> @customer
GROUP BY
    `month`,
    channel
ORDER BY
    `month` DESC
LIMIT 12;

Результат оформлен в стиле Standard с отступами в 4 пробела — ровно как его выдаёт форматтер выше. Переключите стиль на Компактный для более компактного SQL или Развёрнутый для ведущих запятых и одного элемента на строку. Этот документация по форматированию описывают детали.

FAQ по форматтеру MySQL

Работает ли это с MariaDB?

Да. MariaDB использует тот же синтаксис кавычек, комментариев и переменных, а исполняемые комментарии вида /*M! … */ сохраняются так же, как и /*! … */ в MySQL.

Удалит ли Minify мои исполняемые комментарии /*! … */?

Нет. Minify удаляет обычные комментарии, но сохраняет исполняемые комментарии и подсказки оптимизатора, потому что сервер выполняет то, что находится внутри них.

Почему форматировщик пишет COUNT(*) без пробела?

Потому что MySQL, пока не включён режим SQL IGNORE_SPACE, не допускает пробелов между COUNT, SUM и некоторыми другими встроенными функциями и открывающей скобкой.

Отправляется ли мой SQL на сервер?

Нет. Форматтер скомпилирован в WebAssembly и работает прямо в вашей вкладке браузера. Ваш SQL никуда не отправляется, не логируется и не хранится, а после загрузки страницы форматтер работает и офлайн.

Может ли форматирование повредить мой запрос?

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

Могу ли я поделиться настройками форматирования с командой?

Да. Каждая настройка, включая расширенные, сохраняется в адресе страницы после знака #, так что копирование адреса или нажатие на «Скопировать ссылку с настройками» позволяет поделиться вашим точным стилем. Ссылка содержит только настройки, никогда — ваш SQL.

// форматирование — далеко не главное

Нравится форматировщик? Познакомьтесь с остальными возможностями SQLly

Нативная рабочая среда SQL для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и этим форматировщиком, встроенным прямо в редактор.