クエリパラメーター
実装済み値を置く位置に :id、? または $1 を書き、結果の上のバーに値を入力すれば、SQL を編集せずにそのまま実行できます。
値を置く位置にプレースホルダーを書き、結果の上のバーに値を一度入力して実行します。値を変えて再実行しても、スクリプト自体は変わらないので、毎日使うクエリをそのまま保存、共有でき、バージョン管理にも入れられます。
SELECT *
FROM beneficiaries
WHERE id = :id;
エディターに :id、 パラメーター エディターと結果の間にストリップが開き、そのための入力欄が 1 つ表示されます。入力するのは 42、次を押します
実行 (Cmd+Enter / Ctrl+Enter)、SQLly は次を送信します WHERE id = 42。SQLly が接続するどのデータベースでも同じように動作します。


プレースホルダースタイル
:name- 名前付きプレースホルダーは、すべてのエンジンで使えます。同じ名前を 2 回使っても、入力は 1 つです:
WHERE a.client_id = :client_id OR b.client_id = :client_id。名前は大文字小文字を区別しないため:IDそして:id値を共有します。 ?- PostgreSQL 以外のすべてのエンジンで使える位置指定プレースホルダー(PostgreSQL では
?は JSON 演算子です)。この帯には、それらが次のように一覧表示されます?1,?2…スクリプト内に現れる順に番号を振り、1 つのステートメントだけを実行してもその番号を保ちます。SQLite の番号付き形式、?3、独自の番号を保持します。 $1- PostgreSQL と DuckDB の番号付きプレースホルダー。
$12 回使われた場合は 1 つの入力として扱われます。 @name- SQL Server 独自のパラメータースタイル。
@nameスクリプトで宣言されないもの、たとえばWHERE CustomerID = @CustomerId、他のプレースホルダーと同じように入力欄が表示されます。スクリプト自身がバインドする変数はそのまま残されます。次のものはDECLAREリスト (テーブル変数も)、対象のSET @x,SELECT @x =またはFETCH … INTO @x、次のパラメータ名EXEC dbo.Proc @Id = …,@@ROWCOUNT-style の関数、およびプロシージャ、関数、トリガーを作成するスクリプト内のすべての名前(プロシージャモードがそれらを入力します)。MySQL では@nameはユーザー変数であり、値を求めることはありません。




値の送信方法
値は、データベースが理解できるリテラルに変換されてエスケープされるため、引用符、バックスラッシュ、または ' OR '1'='1 値の中は常にデータとして扱われます。入力した内容によって値の種類が決まります:
- 数字
42,-3.5そして1e6数値として渡されます。郵便番号のような先頭にゼロが付く数値は007、テキストのままです。true/false- ブール値は、お使いのエンジンでの表記のまま書き込まれます(
1/0SQL Server と MySQL で)。 NULL- SQL NULL。空の入力は決してNULLではありません。値が未入力の状態であり、「実行」時に入力を求められます。
- その他
- エンジンに合わせて引用符で囲まれたテキスト:
activeになります'active'. 'quoted'- テキストとして扱うには、値をシングルクォートで囲みます:
'42'文字列 42 を送信し、''空の文字列を送信します。
int_col = :id そして text_col = :id どちらも同じ入力で動作します。値が必要なのは、実行するステートメントだけです
ストリップにはスクリプト内のすべてのプレースホルダーが一覧表示されるので、値を先に入力しておけます。実行時に値が必要なのは、実際に走る範囲(選択範囲または現在のステートメント)にあるプレースホルダーだけです。1 つでも空のままなら何も送信されません。ステータスバーがその名前を示し、その行は 必須、カーソルがそこにジャンプします。


Explain とクエリプランコマンドは同じ値を使うため、プランは実際に実行するクエリのものになります。
プレースホルダーに型と既定値を指定する
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: 行は引き続き動作します。