Параметры запроса

функциональный

Пишите :id, ? или $1 там, где должно стоять значение, введите значение в поле над результатами и запускайте запрос, не меняя SQL.

Напишите заполнитель там, где должно быть значение, введите значение один раз в панели над результатами и запустите. Поменяйте значение и запустите снова: сам скрипт при этом не меняется, поэтому запрос, который вы запускаете каждый день, остаётся запросом, который можно сохранить, дать коллеге и держать в системе контроля версий.

SELECT *
FROM beneficiaries
WHERE id = :id;

Как только в редакторе появляется :id, Параметры панель открывается между редактором и результатами с одним полем ввода для него. Введите 42, нажмите Выполнить (Cmd+Enter / Ctrl+Enter), и SQLly отправляет WHERE id = 42. Это работает одинаково во всех базах данных, к которым подключается SQLly.

SQLly
Запрос MariaDB с WHERE id = :id, панель параметров со значением 42 и соответствующая строка в результатах.Запрос MariaDB с WHERE id = :id, панель параметров со значением 42 и соответствующая строка в результатах.
Запрос MariaDB с WHERE id = :id, панель параметров со значением 42 и соответствующая строка в результатах.

Стили заполнителей

: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 это пользовательская переменная и никогда не запрашивает значение.
SQLly
Два именованных плейсхолдера, :client_id и :status, заполняются в строке параметров отфильтрованными ниже получателями.Два именованных плейсхолдера, :client_id и :status, заполняются в строке параметров отфильтрованными ниже получателями.
Два именованных плейсхолдера, :client_id и :status, заполняются в строке параметров отфильтрованными ниже получателями.
SQLly
Скрипт SQL Server, который объявляет @top через DECLARE и фильтрует по необъявленному @Country: поле в панели параметров есть только у @Country — со значением France.Скрипт SQL Server, который объявляет @top через DECLARE и фильтрует по необъявленному @Country: поле в панели параметров есть только у @Country — со значением France.
Скрипт SQL Server, который объявляет @top через DECLARE и фильтрует по необъявленному @Country: поле в панели параметров есть только у @Country — со значением France.

Как отправляется значение

Значения превращаются в литерал, который понимает ваша база данных, и экранируются под неё, поэтому кавычка, обратная косая черта или ' OR '1'='1 в значении — это всегда просто данные. Тип значения определяет то, что вы вводите:

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

Значения нужны только тому оператору, который вы выполняете

Полоса перечисляет все заполнители в скрипте, чтобы вы могли заранее заполнить значения. При запуске значения нужны только заполнителям того, что действительно выполняется (выделенное или текущий оператор). Если хоть один пуст, ничего не отправляется: строка состояния называет его, а в его строке написано обязательно, и курсор перемещается в него.

SQLly
Два позиционных плейсхолдера ?: первый содержит дату, второй пуст и помечен как обязательный после того, как запуск был заблокирован.Два позиционных плейсхолдера ?: первый содержит дату, второй пуст и помечен как обязательный после того, как запуск был заблокирован.
Два позиционных плейсхолдера ?: первый содержит дату, второй пуст и помечен как обязательный после того, как запуск был заблокирован.

Объяснить и команды плана запроса используют те же значения, поэтому план предназначен для запроса, который вы действительно выполните.

Задайте заполнителю тип и значение по умолчанию

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 запускается снова. Для именованных плейсхолдеров недавно использованные значения появляются рядом с полем ввода как чипы в один клик, а форматтер оставляет плейсхолдеры ровно в том виде, в каком они написаны.

Выключение. Если вы никогда не хотите, чтобы плейсхолдеры запрашивали значения, очистите Настройки › Редактор › Общие › Параметры запроса › Запрашивать значения для плейсхолдеров :name, ? и $1. -- sqlly param: строки продолжают работать.