查詢參數

功能性的

在值的位置寫 :id、? 或 $1,在結果上方輸入值,不必修改 SQL 就能執行。

在值的位置寫上佔位符,在結果上方的參數列輸入值一次,然後執行。換個值再跑一次:指令碼本身始終不變,你每天重複使用的查詢依然是能儲存、共用、放進版本控制的查詢。

SELECT *
FROM beneficiaries
WHERE id = :id;

只要編輯器裡有 :id、 參數 列就會在編輯器與結果之間開啟,並為它提供一個輸入框。輸入 42,按 執行 (Cmd+Enter 鍵 / Ctrl+Enter 鍵),SQLly 就會送出 WHERE id = 42。它在 SQLly 連線的每一種資料庫上運作方式都相同。

SQLly
一個 MariaDB 查詢,條件是 WHERE id = :id,參數列填入 42,結果中顯示符合的資料列。一個 MariaDB 查詢,條件是 WHERE id = :id,參數列填入 42,結果中顯示符合的資料列。
一個 MariaDB 查詢,條件是 WHERE id = :id,參數列填入 42,結果中顯示符合的資料列。

預留位置樣式

: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 是一個使用者變數,從不要求輸入值。
SQLly
兩個具名預留位置 :client_id 和 :status,在參數列中填入,下方就會列出篩選後的受益人。兩個具名預留位置 :client_id 和 :status,在參數列中填入,下方就會列出篩選後的受益人。
兩個具名預留位置 :client_id 和 :status,在參數列中填入,下方就會列出篩選後的受益人。
SQLly
一個 SQL Server 指令碼,以 DECLARE 宣告了 @top,並以未宣告的 @Country 進行篩選:在參數列中只有 @Country 有輸入欄,填入的是 France。一個 SQL Server 指令碼,以 DECLARE 宣告了 @top,並以未宣告的 @Country 進行篩選:在參數列中只有 @Country 有輸入欄,填入的是 France。
一個 SQL Server 指令碼,以 DECLARE 宣告了 @top,並以未宣告的 @Country 進行篩選:在參數列中只有 @Country 有輸入欄,填入的是 France。

值怎麼送出去

值會轉換成你的資料庫能理解的字面值,並為它做跳脫,因此引號、反斜線或 ' 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,而 '' 傳送空字串。
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: 列仍然可以正常運作。