Abfrageparameter

funktional

Schreibe :id, ? oder $1 dorthin, wo ein Wert hingehört, tippe den Wert über den Ergebnissen ein und führe aus, ohne das SQL zu bearbeiten.

Schreibe einen Platzhalter dorthin, wo ein Wert hingehört, tippe den Wert einmal im Streifen über den Ergebnissen ein und führe aus. Ändere den Wert und führe erneut aus: Das Skript selbst ändert sich nie, sodass eine Abfrage, die du jeden Tag wiederverwendest, eine Abfrage bleibt, die du speichern, teilen und in der Versionsverwaltung behalten kannst.

SELECT *
FROM beneficiaries
WHERE id = :id;

Sobald der Editor den :id, ein Parameter Leiste öffnet sich zwischen Editor und Ergebnissen, mit einer Eingabe dafür. Tippe 42, drücke Ausführen (Cmd+Eingabe / Strg+Eingabe), und SQLly sendet WHERE id = 42. Das funktioniert bei jeder Datenbank gleich, mit der sich SQLly verbindet.

SQLly
Eine MariaDB-Abfrage mit WHERE id = :id, die Parameterleiste mit dem Wert 42, und die passende Zeile in den Ergebnissen.Eine MariaDB-Abfrage mit WHERE id = :id, die Parameterleiste mit dem Wert 42, und die passende Zeile in den Ergebnissen.
Eine MariaDB-Abfrage mit WHERE id = :id, die Parameterleiste mit dem Wert 42, und die passende Zeile in den Ergebnissen.

Platzhalterstile

:name
Ein benannter Platzhalter, in jeder Engine. Nimm denselben Namen zweimal, und es ist eine einzige Eingabe: WHERE a.client_id = :client_id OR b.client_id = :client_id. Bei Namen spielt Groß-/Kleinschreibung keine Rolle, also :ID und :id teilen einen Wert.
?
Ein Positionsplatzhalter, auf jeder Engine außer PostgreSQL (wo ? ein JSON-Operator ist). Die Leiste listet sie als ?1, ?2… in der Reihenfolge ihres Auftretens im Skript, und behält diese Nummerierung, wenn du nur eine Anweisung ausführst. Die nummerierte Form von SQLite, ?3, behält ihre eigene Nummer.
$1
Der nummerierte Platzhalter von PostgreSQL und DuckDB. $1 zweimal verwendet ist eine Eingabe.
@name
SQL Servers eigener Parameterstil. Ein @name , die das Skript nie deklariert, WHERE CustomerID = @CustomerId, erhält eine Eingabe wie jeder andere Platzhalter. Variablen, die das Skript selbst bindet, bleiben unberührt: alles in einer DECLARE Liste (auch Tabellenvariablen), das Ziel von SET @x, SELECT @x = oder FETCH … INTO @x, die Parameternamen in EXEC dbo.Proc @Id = …, @@ROWCOUNT-Stil-Funktionen und jeder Name in einem Skript, das eine Prozedur, Funktion oder einen Trigger anlegt (der Prozedurmodus füllt die aus). Bei MySQL @name ist eine Benutzervariable und fragt niemals nach einem Wert.
SQLly
Zwei benannte Platzhalter, :client_id und :status, gefüllt im Parameterbereich mit den unten gefilterten Begünstigten.Zwei benannte Platzhalter, :client_id und :status, gefüllt im Parameterbereich mit den unten gefilterten Begünstigten.
Zwei benannte Platzhalter, :client_id und :status, gefüllt im Parameterbereich mit den unten gefilterten Begünstigten.
SQLly
Ein SQL Server-Skript, das @top deklariert und nach einem nicht deklarierten @Country filtert: nur @Country hat ein Eingabefeld im Parameterbereich, gefüllt mit Frankreich.Ein SQL Server-Skript, das @top deklariert und nach einem nicht deklarierten @Country filtert: nur @Country hat ein Eingabefeld im Parameterbereich, gefüllt mit Frankreich.
Ein SQL Server-Skript, das @top deklariert und nach einem nicht deklarierten @Country filtert: nur @Country hat ein Eingabefeld im Parameterbereich, gefüllt mit Frankreich.

Wie ein Wert gesendet wird

Werte werden in ein Literal umgewandelt, das deine Datenbank versteht, und dafür abgesichert, sodass ein Anführungszeichen, ein Backslash oder ein ' OR '1'='1 in einem Wert immer nur Daten sind. Was du eingibst, bestimmt die Art des Wertes:

Zahlen
42, -3.5 und 1e6 gehen als Zahlen ein. Eine Zahl mit führender Null, wie eine Postleitzahl 007, bleibt Text.
true / false
Boolesche Werte, geschrieben so, wie deine Engine sie schreibt (1/0 auf SQL Server und MySQL).
NULL
SQL NULL. Eine leere Eingabe ist niemals NULL: sie fehlt, und Ausführen fragt danach.
Alles andere
Text, in Anführungszeichen für deine Engine: active wird 'active'.
'quoted'
Setze einen Wert in einfache Anführungszeichen, um Text zu erzwingen: '42' sendet den String 42, und '' sendet einen leeren String.
PostgreSQL. Jeder Wert außer NULL wird als untypisiertes Literal gesendet, das PostgreSQL als den Typ liest, den der Vergleich benötigt, also int_col = :id und text_col = :id funktionieren beide mit demselben Eingabewert.

Nur die Anweisung, die du ausführst, braucht Werte

Der Streifen listet jeden Platzhalter im Skript auf, sodass du Werte vorab eintragen kannst. Beim Ausführen brauchen nur die Platzhalter in dem, was tatsächlich läuft (die Auswahl oder die aktuelle Anweisung), einen Wert. Ist einer leer, wird nichts gesendet: Die Statusleiste nennt ihn, seine Zeile zeigt Erforderlich, und der Cursor springt hinein.

SQLly
Zwei positionale ?-Platzhalter: der erste enthält ein Datum, der zweite ist leer und wird nach einem blockierten Run als erforderlich markiert.Zwei positionale ?-Platzhalter: der erste enthält ein Datum, der zweite ist leer und wird nach einem blockierten Run als erforderlich markiert.
Zwei positionale ?-Platzhalter: der erste enthält ein Datum, der zweite ist leer und wird nach einem blockierten Run als erforderlich markiert.

Erklären und die Abfrageplan-Befehle verwenden dieselben Werte, sodass der Plan für die Abfrage gilt, die du wirklich ausführst.

Gib einem Platzhalter einen Typ und einen Standardwert

A -- sqlly param: Zeile tippt einen Platzhalter ein: Die Eingabe wird vor Run geprüft, und eine leere Eingabe fällt auf den Standardwert zurück.

-- sqlly param: :since date = 2026-01-01
-- sqlly param: :limit int = 50
SELECT * FROM orders WHERE created_at >= :since LIMIT :limit;

Typen sind text, int, decimal, bool, date, datetime, time, uuid, json und binary. Dieselbe Zeile mit einem @name deklariert einen Parameter, den SQLly für @name selbst ersetzt; siehe SQLly-Direktiven.

Was niemals ein Platzhalter ist

SQLly liest dein SQL so, wie deine Datenbank es liest, und fragt deshalb nicht nach Werten, die keine Parameter sind: alles in einem String, einem Kommentar, einem in Anführungszeichen gesetzten Namen oder einem PostgreSQL $$ Funktionskörper; :: Casts; Array-Slices wie arr[lo:hi]; JSON-Pfade wie metadata:country; MySQLs := und Schleifenlabels; SQL Server sqlcmd-Zeilen wie :setvar; und Oracles :new / :old in Triggern.

Werte bleiben beim Tab

Eingegebene Werte werden mit dem Tab gespeichert, reisen mit ihm zu einem anderen Fenster und kehren zurück, wenn SQLly erneut gestartet wird. Bei benannten Platzhaltern erscheinen kürzlich verwendete Werte als One-Click-Chips neben der Eingabe, und der Formatter lässt Platzhalter genau so stehen, wie sie geschrieben wurden.

Ausschalten. Wenn Platzhalter nie nach Werten fragen sollen, leere Einstellungen › Editor › Allgemein › Abfrageparameter › Nach Werten für die Platzhalter :name, ? und $1 fragen. -- sqlly param: Zeilen funktionieren weiterhin.