查询参数

功能的

在放值的位置写 :id、? 或 $1,在结果上方的输入条里填值,不用改 SQL 就能运行。

在放值的位置写一个占位符,在结果上方的输入条里填一次值,然后运行。改个值再跑一遍:脚本本身始终不变,于是你每天复用的查询仍然是可以保存、分享、纳入版本控制的查询。

SELECT *
FROM beneficiaries
WHERE id = :id;

编辑器中一旦出现 :id、 参数 条便会在编辑器和结果之间打开,其中有一个对应的输入框。输入 42,按 运行 (Cmd+输入 / Ctrl+输入),然后由 SQLly 发送 WHERE id = 42。它在 SQLly 连接的每个数据库上工作方式相同。

SQLly
一个 WHERE id = :id 的 MariaDB 查询,参数栏中填 42,结果里显示匹配的行。一个 WHERE id = :id 的 MariaDB 查询,参数栏中填 42,结果里显示匹配的行。
一个 WHERE id = :id 的 MariaDB 查询,参数栏中填 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-式函数,以及创建存储过程、函数或触发器的脚本里的每个名称(存储过程模式会自动填好)。在 MySQL @name 是一个用户变量,绝不会让你填值。
SQLly
两个具名占位符 :client_id 和 :status,在参数栏中填写,下方显示筛选出的受益人。两个具名占位符 :client_id 和 :status,在参数栏中填写,下方显示筛选出的受益人。
两个具名占位符 :client_id 和 :status,在参数栏中填写,下方显示筛选出的受益人。
SQLly
一个 SQL Server 脚本声明了 @top 并按未声明的 @Country 筛选:参数栏中只有 @Country 有输入框,里面填的是 France。一个 SQL Server 脚本声明了 @top 并按未声明的 @Country 筛选:参数栏中只有 @Country 有输入框,里面填的是 France。
一个 SQL Server 脚本声明了 @top 并按未声明的 @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 的 := 和循环标签;SQL Server sqlcmd 行,例如 :setvar;以及 Oracle 的 :new / :old 在触发器中。

值与标签页绑定

输入的值会随标签页一起保存,跟着标签页走到另一个窗口,并在 SQLly 重新启动后回来。对于具名占位符,最近用过的值会以一键可选的小标签形式出现在输入框旁边,格式化功能也会原样保留占位符。

关闭它。 如果你从不希望占位符请求值,请清除 设置 › 编辑器 › 常规 › 查询参数 › 请求 :name、? 和 $1 占位符的值. -- sqlly param: 行会照常工作。