PostgreSQL 42P02: não há parâmetro
O SQL contém um espaço reservado no estilo $1, mas nenhum valor de parâmetro foi vinculado, geralmente porque o SQL do driver foi executado diretamente ou porque há espaços reservados entre aspas.
- SQLSTATE
42P02- Nome
undefined_parameter
O que significa
Os próprios espaços reservados do PostgreSQL são $1, $2 e assim por diante, preenchidos quando uma instrução é preparada ou executada com parâmetros vinculados. Se o texto contém $1 mas a instrução foi enviada sem parâmetros, o PostgreSQL não tem nada para substituir e falha com 42P02 (undefined_parameter).
Isso geralmente significa que SQL copiado do código da aplicação ou de um log foi executado manualmente, ou que um driver enviou uma string de consulta com placeholders por um caminho que não os vincula.
Causas comuns
- Executando uma consulta parametrizada copiada do código ou dos logs no psql ou em um editor de SQL.
- Placeholders dentro de uma string ou de um corpo de função com citação de dólares, onde o driver não os substitui.
- A
DObloco ou SQL dinâmico usando$1semEXECUTE ... USING. - Misturando estilos de placeholder de driver:
?ou%sem um só lugar,$1em outro.
Como corrigir
-
Ao executá-lo manualmente, substitua os placeholders por valores literais ou use
PREPAREeEXECUTE.PREPARE find_order(int) AS SELECT * FROM orders WHERE id = $1; EXECUTE find_order(42);
-
Em SQL dinâmico dentro do PL/pgSQL, passe os valores com
USING.DO $$ DECLARE n int; BEGIN EXECUTE 'SELECT count(*) FROM orders WHERE customer_id = $1' INTO n USING 42; RAISE NOTICE '%', n; END; $$; -
No código da aplicação, passe os valores através da API de parâmetros do driver em vez de concatená-los.
Reproduza com segurança
SELECT $1; -- ERROR: there is no parameter $1
Erros relacionados
Mais erros de sintaxe ou violação de regra de acesso
42501permissão negada42846não é possível converter42803a coluna deve aparecer na cláusula GROUP BY42830chave estrangeira inválida42804incompatibilidade de tipo de dado42703a coluna não existe42883função não existe42P01relação não existe
O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.
Trabalhe com PostgreSQL no SQLly
Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.