Parámetros de consulta
funcionalEscribe :id, ? o $1 donde va un valor, escribe el valor encima de los resultados y ejecuta sin editar el SQL.
Escribe un marcador de posición donde va un valor, escribe el valor una vez en la franja encima de los resultados y ejecuta. Cambia el valor y ejecuta de nuevo: el propio script nunca cambia, por lo que una consulta que reutilizas todos los días sigue siendo una consulta que puedes guardar, compartir y mantener en control de versiones.
SELECT *
FROM beneficiaries
WHERE id = :id;
Tan pronto como el editor contenga :id, un Parámetros la franja se abre entre el editor y los resultados, con un solo campo. Escribe 42, presiona
Ejecutar (Cmd+Enter / Ctrl+Enter), y SQLly envía WHERE id = 42. Funciona igual en todas las bases de datos a las que SQLly se conecta.


Estilos de marcadores de posición
:name- Un marcador con nombre, en todos los motores. Usa el mismo nombre dos veces y es una sola entrada:
WHERE a.client_id = :client_id OR b.client_id = :client_id. Los nombres no distinguen mayúsculas de minúsculas, así que:IDy:idcomparten un valor. ?- Un marcador posicional, en todos los motores excepto PostgreSQL (donde
?es un operador JSON). La barra los enumera como?1,?2… en el orden en que aparecen en el script, y mantiene esa numeración cuando ejecutas solo una instrucción. La forma numerada de SQLite,?3, mantiene su propio número. $1- Marcador de posición numerado de PostgreSQL y DuckDB.
$1usado dos veces es una sola entrada. @name- Estilo de parámetro propio de SQL Server. Un
@nameque el script nunca declara, comoWHERE CustomerID = @CustomerId, recibe una entrada como cualquier otro marcador de posición. Las variables que el propio script enlaza se dejan como están: cualquier cosa dentro de unaDECLARElista (también variables de tabla), el objetivo deSET @x,SELECT @x =oFETCH … INTO @x, los nombres de los parámetros enEXEC dbo.Proc @Id = …,@@ROWCOUNT, funciones de ese estilo, y cada nombre en un script que crea un procedimiento, una función o un trigger (el modo Procedimiento los rellena). En MySQL@namees una variable de usuario y nunca pide un valor.




Cómo se envía un valor
Los valores se convierten en un literal que tu base de datos entiende y se escapan para ella, por lo que una comilla, una barra invertida o un ' OR '1'='1 en un valor son solo datos. Lo que escribas decide el tipo de valor:
- Números
42,-3.5y1e6Se ingresan como números. Un número con cero a la izquierda, como un código postal007, permanece como texto.true/false- Booleanos, escritos tal y como los escribe tu motor (
1/0en SQL Server y MySQL). NULL- NULL de SQL. Una entrada vacía nunca es NULL: simplemente falta, y Ejecutar te la pide.
- Cualquier otra cosa
- Texto, entre comillas según tu motor:
activese convierte en'active'. 'quoted'- Envuelve un valor entre comillas simples para forzar que sea texto:
'42'envía la cadena 42, y''envía una cadena vacía.
int_col = :id y text_col = :id ambos funcionan con la misma entrada.Solo la instrucción que ejecutes necesita valores
La franja muestra cada marcador de posición del script, para que puedas completar los valores de antemano. Al ejecutar, solo los marcadores de posición de lo que se ejecuta realmente (la selección o la instrucción actual) necesitan un valor. Si uno está vacío, no se envía nada: la barra de estado lo nombra, su fila dice obligatorio, y el cursor salta a él.


Explicar y los comandos del plan de consulta usan los mismos valores, así que el plan corresponde a la consulta que de verdad vas a ejecutar.
Asigna un tipo y un valor predeterminado a un marcador de posición
A -- sqlly param: línea asigna un tipo a un marcador de posición: la entrada se comprueba antes de ejecutar, y una entrada vacía vuelve al valor predeterminado.
-- sqlly param: :since date = 2026-01-01
-- sqlly param: :limit int = 50
SELECT * FROM orders WHERE created_at >= :since LIMIT :limit;
Los tipos son text, int, decimal, bool,
date, datetime, time, uuid, json
y binary. La misma línea con un @name declara un parámetro que SQLly sustituye por @name sí mismo; ver Directivas de SQLly.
Lo que nunca es un marcador de posición
SQLly lee tu SQL igual que lo lee tu base de datos, así que no te pide valores que no sean parámetros: cualquier cosa que esté dentro de una cadena, un comentario, un nombre entre comillas o un PostgreSQL
$$ cuerpo de la función; :: conversión de tipos; porciones de arrays como
arr[lo:hi]; rutas JSON como metadata:country; de MySQL
:= y etiquetas de bucle; líneas sqlcmd de SQL Server como :setvar; y de Oracle :new / :old en triggers.
Los valores se quedan en la pestaña
Los valores escritos se guardan con la pestaña, la acompañan a otra ventana y vuelven cuando SQLly arranca de nuevo. En los marcadores de posición con nombre, los valores usados recientemente aparecen como chips de un clic junto al campo, y el formateador deja los marcadores de posición tal cual están escritos.
-- sqlly param: las líneas seguirán funcionando.