Основные выводы
- 01Поддерживает PostgreSQL, MySQL, SQLite, BigQuery и стандартный SQL с обработкой ключевых слов, учитывающей диалект.
- 02Выберите случай ключевого слова (UPPERCASE, lowercase или preserve) и отступ (2 пробела, 4 пробела или вкладки).
- 03Работает полностью в вашем браузере — запросы с чувствительными данными никогда не покидают ваше устройство.
- 04Инструмент только переформатирует текст; он не выполняет запросы и не подключается к какой-либо БД.
Почему форматировать SQL перед тем, как вы его делитесь?
Неформатированный SQL действительно сложно рецензировать. Длинные списки SELECT, разбитые на одну строку, непоследовательный отступ в подзапросах и смешанные ключевые слова в случае все замедляют обзор кода и отладку. Правильно отформатированный запрос делает условия JOIN, предложения WHERE и структуру CTE сразу читаемыми.
Форматирование становится еще более важным при обмене запросами через команду с руководством по стилю — UPPERCASE ключевые слова, четырехпробельный отступ, одно предложение в строке. Форматер SQL Handytool последовательно применяет этот стиль ко всему, что вы вставляете, будь то двухстрочный поиск или двухсотстрочный аналитический запрос с несколькими CTE и функциями окна.
Как форматировать SQL запрос
- 01
Вставьте свой SQL
Вставьте любое SQL заявление в входную панель — SELECT, INSERT, UPDATE, DELETE, CREATE или полную цепь CTE. Нет ограничения размера сверх доступной памяти вашего браузера.
- 02
Выберите диалект
Выберите PostgreSQL, MySQL, SQLite, BigQuery или Standard SQL из выпадающего меню. Диалект определяет, как зарезервированные слова и синтаксис, специфичный для производителя, такой как RETURNING или STRUCT, обрабатываются.
- 03
Установите случай ключевого слова и отступ
Выберите UPPERCASE, lowercase или Preserve для установки ключевого слова. Выберите 2 пробела, 4 пробела или вкладки для отступа. Ключевые слова UPPERCASE с 2-пробельным отступом — это наиболее распространенный стиль в общих базах кода.
- 04
Нажмите Format
Отформатированный вывод появляется в правой панели мгновенно. Предложения размещаются на своих собственных строках, условия JOIN выравниваются и подзапросы отступают относительно своего родителя.
- 05
Копируйте и используйте
Нажмите Копировать, чтобы скопировать отформатированный SQL в буфер обмена. Вставьте в IDE, файл SQL, описание PR или фрагмент документации.
Безопасно использовать с производственными шаблонами запросов
Библиотека sql-formatter работает полностью в вашем браузере. Ничего не отправляется на сервер — нет текста запроса, нет названий таблиц, нет образца данных. Это делает его безопасным для форматирования запросов, которые ссылаются на имена реальной схемы или содержат значения образцов из базы данных промежуточной среды.
Одно, чего форматер не будет делать, это выполнять ваш SQL. Это инструмент преобразования текста только. Вы можете безопасно вставить запросы, которые удалили бы таблицы или удалили бы строки — инструмент обрабатывает их как обычный текст и переформатирует их без выполнения единого заявления.
Часто задаваемые вопросы о форматере SQL
Какие диалекты SQL поддерживает этот форматер?
Стандартный SQL, PostgreSQL, MySQL, SQLite и BigQuery. Каждый диалект правильно обрабатывает синтаксис, специфичный для производителя, такой как предложение RETURNING PostgreSQL, идентификаторы обратного тика MySQL и тип STRUCT BigQuery.
Выполнит ли форматер мой запрос?
Нет. Он только переформатирует текст запроса. Он не подключается к какой-либо БД, не проверяет имена столбцов и не выполняет заявления.
Загружается ли мой SQL на какой-либо сервер?
Нет. Библиотека sql-formatter работает в вашем браузере. Текст вашего запроса остается на вашем устройстве.
Почему моя хранимая процедура или блок PL/pgSQL форматируется странно?
Процедурные SQL блоки (PL/pgSQL, блоки BEGIN…END, разделы DECLARE) находятся вне того, что охватывает грамматика форматера. Форматируйте меньшие фрагменты SELECT или DML из внутри этих блоков отдельно.
Какой случай ключевого слова лучше для общей базы кода?
Ключевые слова UPPERCASE — это наиболее широко принятое соглашение — они визуально отделяют структуру SQL от имен идентификаторов. Отступ в два или четыре пробела является вопросом предпочтения команды.