Parâmetros de consulta
funcionalEscreva :id, ? ou $1 no lugar de um valor, digite o valor acima dos resultados e execute sem editar o SQL.
Escreva um espaço reservado onde um valor deve ser inserido, digite o valor uma vez na faixa acima dos resultados e execute. Altere o valor e execute novamente: o próprio script nunca muda, então uma consulta que você reutiliza todos os dias permanece uma consulta que você pode salvar, compartilhar e manter no controle de versão.
SELECT *
FROM beneficiaries
WHERE id = :id;
Assim que o editor tiver :id, um Parâmetros a barra se abre entre o editor e os resultados com um único campo para isso. Digite 42, pressione
Executar (Cmd+Enter / Ctrl+Enter), e SQLly envia WHERE id = 42. Funciona igual em todos os bancos de dados em que o SQLly entra.


Estilos de espaço reservado
:name- Um placeholder nomeado, em todos os mecanismos. Use o mesmo nome duas vezes e ele é uma única entrada:
WHERE a.client_id = :client_id OR b.client_id = :client_id. Os nomes não diferenciam maiúsculas de minúsculas, então:IDe:idcompartilham um valor. ?- Um placeholder posicional, em todos os mecanismos, exceto PostgreSQL (onde
?é um operador JSON). A faixa os lista como?1,?2… na ordem em que aparecem no script, e mantém essa numeração quando você executa apenas uma instrução. A forma numerada do SQLite,?3, mantém seu próprio número. $1- Placeholder numerado do PostgreSQL e DuckDB.
$1usado duas vezes é uma entrada. @name- Estilo de parâmetro próprio do SQL Server. Um
@nameque o script nunca declara, tal comoWHERE CustomerID = @CustomerId, recebe uma entrada como qualquer outro placeholder. Variáveis que o próprio script vincula ficam intocadas: qualquer coisa em umaDECLARElista (variáveis de tabela também), o destino deSET @x,SELECT @x =ouFETCH … INTO @x, os nomes de parâmetros emEXEC dbo.Proc @Id = …,@@ROWCOUNT, funções desse estilo, e todo nome em um script que cria um procedimento, uma função ou um gatilho (o modo Procedimento preenche esses). No MySQL@nameé uma variável de usuário e nunca pede um valor.




Como um valor é enviado
Os valores são transformados em um literal que seu banco de dados entende e escapados para ele, então uma aspa, uma barra invertida ou um ' OR '1'='1 em um valor é sempre apenas dado. O que você digita decide o tipo de valor:
- Números
42,-3.5e1e6entram como números. Um número com zero à esquerda, como um CEP007, permanece como texto.true/false- Booleanos, escritos da maneira que seu mecanismo os representa (
1/0no SQL Server e MySQL). NULL- SQL NULL. Uma entrada vazia nunca é NULL: é um valor que falta, e o botão Executar pede ele.
- Qualquer outra coisa
- Texto, entre aspas para o seu mecanismo:
activese torna'active'. 'quoted'- Coloque um valor entre aspas simples para forçar como texto:
'42'envia a string 42, e''envia uma string vazia.
int_col = :id e text_col = :id ambos funcionam com a mesma entrada.Apenas a instrução que você executa precisa de valores
A faixa lista todos os placeholders do script, para que você possa preencher os valores com antecedência. Ao executar, apenas os placeholders do que for realmente executado (a seleção ou a instrução atual) precisam de um valor. Se um deles estiver vazio, nada é enviado: a barra de status o nomeia, e a linha dele diz obrigatório, e o cursor pula para ele.


Explicar e os comandos do plano de consulta usam os mesmos valores, então o plano é da consulta que você realmente vai executar.
Dê a um placeholder um tipo e um padrão
A -- sqlly param: linha atribui um tipo a um espaço reservado: a entrada é verificada antes de Executar, e uma entrada vazia volta ao padrão.
-- sqlly param: :since date = 2026-01-01
-- sqlly param: :limit int = 50
SELECT * FROM orders WHERE created_at >= :since LIMIT :limit;
Tipos são text, int, decimal, bool,
date, datetime, time, uuid, json
e binary. A mesma linha com um @name declara um parâmetro que o SQLly substitui por @name a si mesmo; veja Diretivas do SQLly.
O que nunca é um espaço reservado
O SQLly lê o seu SQL assim como o seu banco de dados lê, então ele não pede valores que não sejam parâmetros: qualquer coisa dentro de uma string, um comentário, um nome entre aspas ou um PostgreSQL
$$ corpo da função; :: casts; fatias de arrays como
arr[lo:hi]; caminhos JSON como metadata:country; do MySQL
:= e rótulos de loop; linhas sqlcmd do SQL Server como :setvar; e da Oracle :new / :old em gatilhos.
Os valores permanecem com a aba
Os valores digitados são salvos junto com a aba, viajam com ela para outra janela e voltam quando o SQLly é reiniciado. Para espaços reservados nomeados, os valores usados recentemente aparecem como chips de um clique ao lado do campo, e o formatador deixa os espaços reservados exatamente como foram escritos.
-- sqlly param: as linhas continuam funcionando.