Abfrageparameter
funktionalSchreibe :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.


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:IDund:idteilen 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.
$1zweimal 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 einerDECLAREListe (auch Tabellenvariablen), das Ziel vonSET @x,SELECT @x =oderFETCH … INTO @x, die Parameternamen inEXEC 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@nameist eine Benutzervariable und fragt niemals nach einem Wert.




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.5und1e6gehen als Zahlen ein. Eine Zahl mit führender Null, wie eine Postleitzahl007, bleibt Text.true/false- Boolesche Werte, geschrieben so, wie deine Engine sie schreibt (
1/0auf 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:
activewird'active'. 'quoted'- Setze einen Wert in einfache Anführungszeichen, um Text zu erzwingen:
'42'sendet den String 42, und''sendet einen leeren String.
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.


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.
-- sqlly param: Zeilen funktionieren weiterhin.