查询编辑器

查询参数

查询参数允许你使用占位符编写查询,并在运行时填入其值,例如:

SELECT * FROM orders
WHERE status = :status AND total > :min_total;

当你运行此查询时,TablePlus 会提示你输入 :status 和 :min_total 的值,替换占位符后将最终查询发送至服务器。

启用查询参数

查询参数默认处于关闭状态。要启用它们,请点击编辑器左下角的 SQL Editor settings 按钮(齿轮图标),然后选择 Query params options > Enable query params。

你也可以在 Settings > Editor 中启用 Enable query params。1

填写这些值

当你执行包含参数的查询时,Variables 窗口会打开,每行显示一个参数。输入值,然后点击 Apply(⌘ + Return)。

这些值会原样插入到查询中,因此对于字符串,请务必添加引号,例如 'shipped'。

TablePlus 会记住你输入的值,并在下次自动填充。要移除不再使用的保存变量,请选择它们,然后点击 Cleanup。

显示两个参数值的“变量”窗口
输入参数值

修改参数格式

选择 Query params options > Change query params format 以选择占位符语法。窗口将显示所选格式的示例。

格式 示例
: SELECT * FROM orders WHERE id = :id
百分比 SELECT * FROM orders WHERE id = %id%
问号 SELECT * FROM orders WHERE id = ?
美元符号 SELECT * FROM orders WHERE id = ${id}
美元 SELECT * FROM orders WHERE id = $id
双花括号 SELECT * FROM orders WHERE id = {{id}}

默认情况下,TablePlus 会忽略引号内的占位符。若要查找引号内的占位符,请启用 Allow searching for variables in quoted strings。

查询参数选项窗口
查询参数选项

正在寻找用于从查询(例如 -- tableplus barchart x: a, y: b)绘制图表的注释吗?请参阅 处理查询结果。


  1. 在 Windows 和 Linux 上,使用 Ctrl + , 打开“偏好设置”。 ↩︎