クエリパラメーター

実装済み

値を置く位置に :id、? または $1 を書き、結果の上のバーに値を入力すれば、SQL を編集せずにそのまま実行できます。

値を置く位置にプレースホルダーを書き、結果の上のバーに値を一度入力して実行します。値を変えて再実行しても、スクリプト自体は変わらないので、毎日使うクエリをそのまま保存、共有でき、バージョン管理にも入れられます。

SELECT *
FROM beneficiaries
WHERE id = :id;

エディターに :id、 パラメーター エディターと結果の間にストリップが開き、そのための入力欄が 1 つ表示されます。入力するのは 42、次を押します 実行 (Cmd+Enter / Ctrl+Enter)、SQLly は次を送信します WHERE id = 42。SQLly が接続するどのデータベースでも同じように動作します。

SQLly
WHERE id = :id を含む MariaDB クエリ、42 が入ったパラメーターストリップ、結果内の一致する行。WHERE id = :id を含む MariaDB クエリ、42 が入ったパラメーターストリップ、結果内の一致する行。
WHERE id = :id を含む MariaDB クエリ、42 が入ったパラメーターストリップ、結果内の一致する行。

プレースホルダースタイル

: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 の番号付きプレースホルダー。 $1 2 回使われた場合は 1 つの入力として扱われます。
@name
SQL Server 独自のパラメータースタイル。 @name スクリプトで宣言されないもの、たとえば WHERE CustomerID = @CustomerId、他のプレースホルダーと同じように入力欄が表示されます。スクリプト自身がバインドする変数はそのまま残されます。次のものは DECLARE リスト (テーブル変数も)、対象の SET @x, SELECT @x = または FETCH … INTO @x、次のパラメータ名 EXEC dbo.Proc @Id = …, @@ROWCOUNT-style の関数、およびプロシージャ、関数、トリガーを作成するスクリプト内のすべての名前(プロシージャモードがそれらを入力します)。MySQL では @name はユーザー変数であり、値を求めることはありません。
SQLly
名前付きプレースホルダー :client_id と :status の 2 つが「パラメーター」バーに入力され、その下に絞り込まれた受益者が表示されています。名前付きプレースホルダー :client_id と :status の 2 つが「パラメーター」バーに入力され、その下に絞り込まれた受益者が表示されています。
名前付きプレースホルダー :client_id と :status の 2 つが「パラメーター」バーに入力され、その下に絞り込まれた受益者が表示されています。
SQLly
@top を DECLARE し、宣言されていない @Country でフィルタする SQL Server スクリプト:パラメータストリップに入力欄があるのは @Country だけで、France が入力されています。@top を DECLARE し、宣言されていない @Country でフィルタする SQL Server スクリプト:パラメータストリップに入力欄があるのは @Country だけで、France が入力されています。
@top を DECLARE し、宣言されていない @Country でフィルタする SQL Server スクリプト:パラメータストリップに入力欄があるのは @Country だけで、France が入力されています。

値の送信方法

値は、データベースが理解できるリテラルに変換されてエスケープされるため、引用符、バックスラッシュ、または ' OR '1'='1 値の中は常にデータとして扱われます。入力した内容によって値の種類が決まります:

数字
42, -3.5 そして 1e6 数値として渡されます。郵便番号のような先頭にゼロが付く数値は 007、テキストのままです。
true / false
ブール値は、お使いのエンジンでの表記のまま書き込まれます(1/0 SQL Server と MySQL で)。
NULL
SQL NULL。空の入力は決してNULLではありません。値が未入力の状態であり、「実行」時に入力を求められます。
その他
エンジンに合わせて引用符で囲まれたテキスト: active になります 'active'.
'quoted'
テキストとして扱うには、値をシングルクォートで囲みます: '42' 文字列 42 を送信し、 '' 空の文字列を送信します。
PostgreSQL。 NULL 以外のすべての値は型なしリテラルとして送信され、PostgreSQL は比較に必要な型として読み取るため、 int_col = :id そして text_col = :id どちらも同じ入力で動作します。

値が必要なのは、実行するステートメントだけです

ストリップにはスクリプト内のすべてのプレースホルダーが一覧表示されるので、値を先に入力しておけます。実行時に値が必要なのは、実際に走る範囲(選択範囲または現在のステートメント)にあるプレースホルダーだけです。1 つでも空のままなら何も送信されません。ステータスバーがその名前を示し、その行は 必須、カーソルがそこにジャンプします。

SQLly
位置指定の ? プレースホルダーが 2 つ。1 つ目には日付が入っており、2 つ目は空で、実行がブロックされたあと必須としてマークされています。位置指定の ? プレースホルダーが 2 つ。1 つ目には日付が入っており、2 つ目は空で、実行がブロックされたあと必須としてマークされています。
位置指定の ? プレースホルダーが 2 つ。1 つ目には日付が入っており、2 つ目は空で、実行がブロックされたあと必須としてマークされています。

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 を再起動したときに復元されます。名前付きプレースホルダーでは、最近使った値が入力欄の横にワンクリックのチップとして表示され、フォーマッターはプレースホルダーを書かれたとおりのまま残します。

オフにする場合。 プレースホルダーが値の入力を求めないようにしたい場合は、次をクリアします :name、?、$1 の各プレースホルダーの値を尋ねる. -- sqlly param: 行は引き続き動作します。