Parámetros de consulta

funcional

Escribe :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.

SQLly
Una consulta de MariaDB con WHERE id = :id, la franja de Parámetros con el valor 42 y la fila correspondiente en los resultados.Una consulta de MariaDB con WHERE id = :id, la franja de Parámetros con el valor 42 y la fila correspondiente en los resultados.
Una consulta de MariaDB con WHERE id = :id, la franja de Parámetros con el valor 42 y la fila correspondiente en los resultados.

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 :ID y :id comparten 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. $1 usado dos veces es una sola entrada.
@name
Estilo de parámetro propio de SQL Server. Un @name que el script nunca declara, como WHERE 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 una DECLARE lista (también variables de tabla), el objetivo de SET @x, SELECT @x = o FETCH … INTO @x, los nombres de los parámetros en EXEC 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 @name es una variable de usuario y nunca pide un valor.
SQLly
Dos marcadores con nombre, :client_id y :status, rellenados en la barra de Parámetros, con los beneficiarios filtrados debajo.Dos marcadores con nombre, :client_id y :status, rellenados en la barra de Parámetros, con los beneficiarios filtrados debajo.
Dos marcadores con nombre, :client_id y :status, rellenados en la barra de Parámetros, con los beneficiarios filtrados debajo.
SQLly
Un script de SQL Server que declara @top y filtra por un @Country no declarado: solo @Country tiene una entrada en la franja de Parámetros, completada con Francia.Un script de SQL Server que declara @top y filtra por un @Country no declarado: solo @Country tiene una entrada en la franja de Parámetros, completada con Francia.
Un script de SQL Server que declara @top y filtra por un @Country no declarado: solo @Country tiene una entrada en la franja de Parámetros, completada con Francia.

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.5 y 1e6 Se ingresan como números. Un número con cero a la izquierda, como un código postal 007, permanece como texto.
true / false
Booleanos, escritos tal y como los escribe tu motor (1/0 en 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: active se 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.
PostgreSQL. Cada valor excepto NULL se envía como un literal sin tipo, que PostgreSQL interpreta como el tipo que necesita la comparación, así que 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.

SQLly
Dos marcadores posicionales ?: el primero contiene una fecha, el segundo está vacío y queda marcado como obligatorio después de que se bloqueara Ejecutar.Dos marcadores posicionales ?: el primero contiene una fecha, el segundo está vacío y queda marcado como obligatorio después de que se bloqueara Ejecutar.
Dos marcadores posicionales ?: el primero contiene una fecha, el segundo está vacío y queda marcado como obligatorio después de que se bloqueara Ejecutar.

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.

Desactivarlo. Si no quieres que los marcadores de posición te pidan valores nunca, desmarca Ajustes › Editor › General › Parámetros de consulta › Preguntar por valores de los marcadores :name, ? y $1. -- sqlly param: las líneas seguirán funcionando.