查詢參數
功能性的在值的位置寫 :id、? 或 $1,在結果上方輸入值,不必修改 SQL 就能執行。
在值的位置寫上佔位符,在結果上方的參數列輸入值一次,然後執行。換個值再跑一次:指令碼本身始終不變,你每天重複使用的查詢依然是能儲存、共用、放進版本控制的查詢。
SELECT *
FROM beneficiaries
WHERE id = :id;
只要編輯器裡有 :id、 參數 列就會在編輯器與結果之間開啟,並為它提供一個輸入框。輸入 42,按
執行 (Cmd+Enter 鍵 / Ctrl+Enter 鍵),SQLly 就會送出 WHERE id = 42。它在 SQLly 連線的每一種資料庫上運作方式都相同。


預留位置樣式
:name- 具名佔位符,每個引擎都支援。同一個名稱用兩次,就是同一個輸入:
WHERE a.client_id = :client_id OR b.client_id = :client_id。名稱不分大小寫,所以:ID和:id共用同一個值。 ?- 位置型佔位符,適用於 PostgreSQL 以外的所有引擎(在 PostgreSQL 裡,
?是 JSON 運算子)。Strip 會把它們列為?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:它是缺失值,而 Run 會要求輸入。
- 其他任何內容
- 文字,為你的資料庫引擎加上引號:
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: 列仍然可以正常運作。