Параметры запроса
функциональныйПишите :id, ? или $1 там, где должно стоять значение, введите значение в поле над результатами и запускайте запрос, не меняя SQL.
Напишите заполнитель там, где должно быть значение, введите значение один раз в панели над результатами и запустите. Поменяйте значение и запустите снова: сам скрипт при этом не меняется, поэтому запрос, который вы запускаете каждый день, остаётся запросом, который можно сохранить, дать коллеге и держать в системе контроля версий.
SELECT *
FROM beneficiaries
WHERE id = :id;
Как только в редакторе появляется :id, Параметры панель открывается между редактором и результатами с одним полем ввода для него. Введите 42, нажмите
Выполнить (Cmd+Enter / Ctrl+Enter), и SQLly отправляет WHERE id = 42. Это работает одинаково во всех базах данных, к которым подключается SQLly.


Стили заполнителей
:name- Именованный заполнитель на каждом движке. Используйте одно и то же имя дважды — и это будет один ввод:
WHERE a.client_id = :client_id OR b.client_id = :client_id. Имена нечувствительны к регистру, поэтому:IDи:idделят одно значение. ?- Позиционный заполнитель на каждом движке, кроме PostgreSQL (где
?является оператором JSON). На панели они перечислены как?1,?2… в порядке их появления в скрипте и сохраняет эту нумерацию, когда вы выполняете один оператор. Пронумерованная форма SQLite,?3сохраняет собственный номер. $1- Пронумерованный заполнитель PostgreSQL и DuckDB.
$1, использованный дважды, — это один ввод. @name- Собственный стиль параметров SQL Server.
@nameкоторый скрипт никогда не объявляет, напримерWHERE CustomerID = @CustomerId, получает значение, как и любой другой заполнитель. Переменные, которые скрипт связывает сам, остаются нетронутыми: всё, что находится вDECLAREсписке (включая табличные переменные), цельSET @x,SELECT @x =илиFETCH … INTO @x, имена параметров вEXEC dbo.Proc @Id = …,@@ROWCOUNT-подобные функции, и каждое имя в скрипте, который создаёт процедуру, функцию или триггер (режим Procedure заполняет их). В MySQL@nameэто пользовательская переменная и никогда не запрашивает значение.




Как отправляется значение
Значения превращаются в литерал, который понимает ваша база данных, и экранируются под неё, поэтому кавычка, обратная косая черта или ' OR '1'='1 в значении — это всегда просто данные. Тип значения определяет то, что вы вводите:
- Числа
42,-3.5и1e6вводятся как числа. Число с ведущим нулем, например почтовый индекс007, остаётся текстом.true/false- Булевы значения в том написании, которое использует ваш движок (
1/0в SQL Server и MySQL). NULL- SQL NULL. Пустой ввод — это не NULL: значение просто не задано, и «Выполнить» запросит его.
- Всё остальное
- Текст, заключённый в кавычки для вашего движка:
activeстановится'active'. 'quoted'- Обрамите значение одинарными кавычками, чтобы заставить его быть текстом:
'42'отправляет строку 42, и''отправляет пустую строку.
int_col = :id и text_col = :id оба работают с одним и тем же вводом.Значения нужны только тому оператору, который вы выполняете
Полоса перечисляет все заполнители в скрипте, чтобы вы могли заранее заполнить значения. При запуске значения нужны только заполнителям того, что действительно выполняется (выделенное или текущий оператор). Если хоть один пуст, ничего не отправляется: строка состояния называет его, а в его строке написано обязательно, и курсор перемещается в него.


Объяснить и команды плана запроса используют те же значения, поэтому план предназначен для запроса, который вы действительно выполните.
Задайте заполнителю тип и значение по умолчанию
A -- sqlly param: строка задаёт тип заполнителя: ввод проверяется перед запуском, а пустой ввод откатывается к значению по умолчанию.
-- sqlly param: :since date = 2026-01-01
-- sqlly param: :limit int = 50
SELECT * FROM orders WHERE created_at >= :since LIMIT :limit;
Типы: text, int, decimal, bool,
date, datetime, time, uuid, json
и binary. Та же строка с @name объявляет параметр, который SQLly заменяет на @name сам; см. Директивы SQLly.
Что никогда не является заполнителем
SQLly читает ваш SQL так же, как ваша база данных, поэтому не запрашивает значения, которые не являются параметрами: всё внутри строки, комментария, имени в кавычках или PostgreSQL
$$ тело функции; :: приведения типов; срезы массивов, такие как
arr[lo:hi]; JSON-пути, такие как metadata:country; у MySQL
:= и метки циклов; строки sqlcmd SQL Server, такие как :setvar; и у Oracle :new / :old в триггерах.
Значения остаются с вкладкой
Введённые значения сохраняются вместе с вкладкой, переезжают вместе с ней в другое окно и возвращаются, когда SQLly запускается снова. Для именованных плейсхолдеров недавно использованные значения появляются рядом с полем ввода как чипы в один клик, а форматтер оставляет плейсхолдеры ровно в том виде, в каком они написаны.
-- sqlly param: строки продолжают работать.