Paramètres de la requête
fonctionnelÉcrivez :id, ? ou $1 là où une valeur doit aller, tapez la valeur au-dessus des résultats, et exécutez sans modifier le SQL.
Écrivez un espace réservé là où une valeur doit aller, tapez la valeur une fois dans la bande au-dessus des résultats, et exécutez. Changez la valeur et exécutez à nouveau : le script lui-même ne change jamais, donc une requête que vous réutilisez chaque jour reste une requête que vous pouvez enregistrer, partager et conserver dans le contrôle de version.
SELECT *
FROM beneficiaries
WHERE id = :id;
Dès que l'éditeur contient :id, un Paramètres une bande s'ouvre entre l'éditeur et les résultats avec une entrée pour elle. Tapez 42, appuyez sur
Exécuter (Cmd+Entrée / Ctrl+Entrée), et SQLly envoie WHERE id = 42. Cela fonctionne de la même manière sur chaque base de données à laquelle SQLly se connecte.


Styles d'espace réservé
:name- Un espace réservé nommé, sur chaque moteur. Utilisez le même nom deux fois et c'est une seule entrée :
WHERE a.client_id = :client_id OR b.client_id = :client_id. Les noms ne sont pas sensibles à la casse, donc:IDet:idpartagent une valeur. ?- Un espace réservé positionnel, sur chaque moteur sauf PostgreSQL (où
?est un opérateur JSON). La barre les énumère comme?1,?2… dans l'ordre où elles apparaissent dans le script, et conserve cette numérotation même si vous n'exécutez qu'une seule instruction. La forme numérotée de SQLite,?3, garde son propre numéro. $1- Espace réservé numéroté de PostgreSQL et de DuckDB.
$1utilisé deux fois est une seule entrée. @name- Style de paramètre propre à SQL Server. Un
@nameque le script ne déclare jamais, commeWHERE CustomerID = @CustomerId, reçoit une entrée comme tout autre espace réservé. Les variables que le script lie lui-même sont laissées intactes : tout dans uneDECLAREliste (variables de table également), la cible deSET @x,SELECT @x =ouFETCH … INTO @x, les noms de paramètres dansEXEC dbo.Proc @Id = …,@@ROWCOUNT, et les fonctions de ce style, ainsi que chaque nom dans un script qui crée une procédure, une fonction ou un trigger (le mode Procédure les remplit). Sur MySQL@nameest une variable utilisateur et ne demande jamais de valeur.




Comment une valeur est envoyée
Les valeurs sont converties en un littéral que votre base de données comprend et sont échappées selon ses règles, donc une apostrophe, un antislash ou un ' OR '1'='1 dans une valeur n'est jamais que des données. C'est ce que vous tapez qui décide du type de valeur :
- Nombres
42,-3.5et1e6sont traités comme des nombres. Un nombre avec un zéro initial, comme un code postal,007, reste du texte.true/false- Booléens, écrits comme votre moteur les orthographie (
1/0sur SQL Server et MySQL). NULL- elle est manquante, et Exécuter vous la demande.
- Tout le reste
- Texte, entre guillemets pour votre moteur :
activedevient'active'. 'quoted'- Entourez une valeur de guillemets simples pour forcer le texte :
'42'envoie la chaîne 42, et''envoie une chaîne vide.
int_col = :id et text_col = :id les deux fonctionnent avec la même entrée.Seule l'instruction que vous exécutez a besoin de valeurs
La bande énumère chaque espace réservé dans le script, donc vous pouvez remplir les valeurs à l'avance. Lorsque vous exécutez, seuls les espaces réservés dans ce qui est effectivement exécuté (la sélection ou l'instruction actuelle) nécessitent une valeur. Si l'un est vide, rien n'est envoyé : la barre d'état le nomme, sa ligne indique requis, et le curseur s'y place.


Expliquer et les commandes de plan de requête utilisent les mêmes valeurs, donc un plan correspond à la requête que vous exécuterez réellement.
Donnez à un espace réservé un type et une valeur par défaut
A -- sqlly param: ligne attribue un type à un espace réservé : la saisie est vérifiée avant l'exécution, et une saisie vide retombe sur la valeur par défaut.
-- sqlly param: :since date = 2026-01-01
-- sqlly param: :limit int = 50
SELECT * FROM orders WHERE created_at >= :since LIMIT :limit;
Les types sont text, int, decimal, bool,
date, datetime, time, uuid, json
et binary. La même ligne avec un @name déclare un paramètre que SQLly substitue pour @name lui-même ; voir Directives SQLly.
Ce qui n'est jamais un espace réservé
SQLly lit votre SQL comme le fait votre base de données, et ne demande donc que les valeurs qui sont de vrais paramètres : tout ce qui se trouve dans une chaîne, un commentaire, un nom entre guillemets ou un PostgreSQL
$$ corps de la fonction ; :: casts ; tranches de tableau telles que
arr[lo:hi]; chemins JSON tels que metadata:country; de MySQL
:= et étiquettes de boucle ; lignes sqlcmd de SQL Server telles que :setvar; et d'Oracle :new / :old dans les déclencheurs.
Les valeurs restent avec l'onglet
Les valeurs saisies sont enregistrées avec l’onglet, voyagent avec lui vers une autre fenêtre, et reviennent lorsque SQLly redémarre. Pour les espaces réservés nommés, les valeurs récemment utilisées apparaissent sous forme de puces cliquables à côté de la saisie, et le formateur laisse les espaces réservés exactement tels qu’ils sont écrits.
-- sqlly param: lignes continuent de fonctionner.