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.

SQLly
Une requête MariaDB avec WHERE id = :id, la barre Paramètres contenant 42, et la ligne correspondante dans les résultats.Une requête MariaDB avec WHERE id = :id, la barre Paramètres contenant 42, et la ligne correspondante dans les résultats.
Une requête MariaDB avec WHERE id = :id, la barre Paramètres contenant 42, et la ligne correspondante dans les résultats.

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 :ID et :id partagent 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. $1 utilisé deux fois est une seule entrée.
@name
Style de paramètre propre à SQL Server. Un @name que le script ne déclare jamais, comme WHERE 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 une DECLARE liste (variables de table également), la cible de SET @x, SELECT @x = ou FETCH … INTO @x, les noms de paramètres dans EXEC 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 @name est une variable utilisateur et ne demande jamais de valeur.
SQLly
Deux espaces réservés nommés, :client_id et :status, remplis dans la zone Paramètres avec les bénéficiaires filtrés ci-dessous.Deux espaces réservés nommés, :client_id et :status, remplis dans la zone Paramètres avec les bénéficiaires filtrés ci-dessous.
Deux espaces réservés nommés, :client_id et :status, remplis dans la zone Paramètres avec les bénéficiaires filtrés ci-dessous.
SQLly
Un script SQL Server qui déclare @top avec DECLARE et filtre sur un @Country non déclaré : seul @Country a un champ dans la bande Paramètres, rempli avec France.Un script SQL Server qui déclare @top avec DECLARE et filtre sur un @Country non déclaré : seul @Country a un champ dans la bande Paramètres, rempli avec France.
Un script SQL Server qui déclare @top avec DECLARE et filtre sur un @Country non déclaré : seul @Country a un champ dans la bande Paramètres, rempli avec France.

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.5 et 1e6 sont 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/0 sur SQL Server et MySQL).
NULL
elle est manquante, et Exécuter vous la demande.
Tout le reste
Texte, entre guillemets pour votre moteur : active devient 'active'.
'quoted'
Entourez une valeur de guillemets simples pour forcer le texte : '42' envoie la chaîne 42, et '' envoie une chaîne vide.
PostgreSQL. Chaque valeur sauf NULL est envoyée comme un littéral non typé, que PostgreSQL interprète comme le type dont la comparaison a besoin, donc 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.

SQLly
Deux espaces réservés positionnels ? : le premier contient une date, le second est vide et marqué comme obligatoire après le blocage de l’exécution.Deux espaces réservés positionnels ? : le premier contient une date, le second est vide et marqué comme obligatoire après le blocage de l’exécution.
Deux espaces réservés positionnels ? : le premier contient une date, le second est vide et marqué comme obligatoire après le blocage de l’exécution.

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.

Désactivation. Si vous ne voulez jamais que les espaces réservés demandent des valeurs, effacez Paramètres › Éditeur › Général › Paramètres de requête › Demander les valeurs des espaces réservés :name, ? et $1. -- sqlly param: lignes continuent de fonctionner.