Parâmetros de consulta

funcional

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

SQLly
Uma consulta MariaDB com WHERE id = :id, a faixa de Parâmetros com 42, e a linha correspondente nos resultados.Uma consulta MariaDB com WHERE id = :id, a faixa de Parâmetros com 42, e a linha correspondente nos resultados.
Uma consulta MariaDB com WHERE id = :id, a faixa de Parâmetros com 42, e a linha correspondente nos resultados.

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 :ID e :id compartilham 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. $1 usado duas vezes é uma entrada.
@name
Estilo de parâmetro próprio do SQL Server. Um @name que o script nunca declara, tal como WHERE CustomerID = @CustomerId, recebe uma entrada como qualquer outro placeholder. Variáveis que o próprio script vincula ficam intocadas: qualquer coisa em uma DECLARE lista (variáveis de tabela também), o destino de SET @x, SELECT @x = ou FETCH … INTO @x, os nomes de parâmetros em EXEC 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.
SQLly
Dois espaços reservados nomeados, :client_id e :status, preenchidos na faixa de Parâmetros com os beneficiários filtrados abaixo.Dois espaços reservados nomeados, :client_id e :status, preenchidos na faixa de Parâmetros com os beneficiários filtrados abaixo.
Dois espaços reservados nomeados, :client_id e :status, preenchidos na faixa de Parâmetros com os beneficiários filtrados abaixo.
SQLly
Um script do SQL Server que DECLARE @top e filtra em um @Country não declarado: somente @Country tem uma entrada na faixa de Parâmetros, preenchida com França.Um script do SQL Server que DECLARE @top e filtra em um @Country não declarado: somente @Country tem uma entrada na faixa de Parâmetros, preenchida com França.
Um script do SQL Server que DECLARE @top e filtra em um @Country não declarado: somente @Country tem uma entrada na faixa de Parâmetros, preenchida com França.

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.5 e 1e6 entram como números. Um número com zero à esquerda, como um CEP 007, permanece como texto.
true / false
Booleanos, escritos da maneira que seu mecanismo os representa (1/0 no 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: active se torna 'active'.
'quoted'
Coloque um valor entre aspas simples para forçar como texto: '42' envia a string 42, e '' envia uma string vazia.
PostgreSQL. Todo valor exceto NULL é enviado como um literal não tipado, que o PostgreSQL interpreta como o tipo que a comparação precisa, então 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.

SQLly
Dois espaços reservados posicionais ?: o primeiro contém uma data, o segundo está vazio e marcado como obrigatório após Executar ser bloqueado.Dois espaços reservados posicionais ?: o primeiro contém uma data, o segundo está vazio e marcado como obrigatório após Executar ser bloqueado.
Dois espaços reservados posicionais ?: o primeiro contém uma data, o segundo está vazio e marcado como obrigatório após Executar ser bloqueado.

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.

Para desativar. Se você nunca quiser que os espaços reservados peçam valores, limpe Configurações › Editor › Geral › Parâmetros de consulta › Perguntar pelos valores dos espaços reservados :name, ? e $1. -- sqlly param: as linhas continuam funcionando.