// Referência de erro do PostgreSQL

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
Categoria
Erro de sintaxe ou violação de regra de acesso
Mensagem de erro
there is no parameter $1

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 DO bloco ou SQL dinâmico usando $1 sem EXECUTE ... USING.
  • Misturando estilos de placeholder de driver: ? ou %s em um só lugar, $1 em outro.

Como corrigir

  1. Ao executá-lo manualmente, substitua os placeholders por valores literais ou use PREPARE e EXECUTE.

    PREPARE find_order(int) AS SELECT * FROM orders WHERE id = $1;
    EXECUTE find_order(42);
  2. 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;
    $$;
  3. 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

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.

// menos erros, correções mais rápidas

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.