查询参数
功能的在放值的位置写 :id、? 或 $1,在结果上方的输入条里填值,不用改 SQL 就能运行。
在放值的位置写一个占位符,在结果上方的输入条里填一次值,然后运行。改个值再跑一遍:脚本本身始终不变,于是你每天复用的查询仍然是可以保存、分享、纳入版本控制的查询。
SELECT *
FROM beneficiaries
WHERE id = :id;
编辑器中一旦出现 :id、 参数 条便会在编辑器和结果之间打开,其中有一个对应的输入框。输入 42,按
运行 (Cmd+输入 / Ctrl+输入),然后由 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-式函数,以及创建存储过程、函数或触发器的脚本里的每个名称(存储过程模式会自动填好)。在 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 的
:= 和循环标签;SQL Server sqlcmd 行,例如 :setvar;以及 Oracle 的 :new / :old 在触发器中。
值与标签页绑定
输入的值会随标签页一起保存,跟着标签页走到另一个窗口,并在 SQLly 重新启动后回来。对于具名占位符,最近用过的值会以一键可选的小标签形式出现在输入框旁边,格式化功能也会原样保留占位符。
-- sqlly param: 行会照常工作。