查询参数
查询参数允许你使用占位符编写查询,并在运行时填入其值,例如:
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)绘制图表的注释吗?请参阅 处理查询结果。
-
在 Windows 和 Linux 上,使用
Ctrl + ,打开“偏好设置”。 ↩︎