// Referência de erro do PostgreSQL

PostgreSQL P0001: exceção lançada

Um RAISE EXCEPTION PL/pgSQL sem seu próprio SQLSTATE. A mensagem é o texto que o autor da função ou gatilho escreveu.

SQLSTATE
P0001
Nome
raise_exception
Categoria
Erro PL/pgSQL
Mensagem de erro
insufficient funds for account 42

O que significa

P0001 (raise_exception) é o código padrão para RAISE EXCEPTION 'message' em PL/pgSQL. Não é um erro do PostgreSQL como tal: uma função, procedimento ou trigger no seu banco de dados decidiu falhar, e o texto da mensagem vem do seu código. CONTEXT as linhas mostram qual função e linha geraram o erro.

Autores de funções podem fornecer um SQLSTATE específico com USING ERRCODE, além de DETAIL e HINT, o que facilita que aplicativos lidem com o erro.

Causas comuns

  • Uma regra de negócio aplicada em um gatilho ou função, como uma verificação de saldo, rejeitou a alteração.
  • Uma função de validação chamada pelo aplicativo gerou um erro para uma entrada inválida.
  • Uma ASSERT uma falha reporta um código diferente, P0004 (assert_failure).

Como corrigir

  1. Leia as CONTEXT linhas para encontrar a função e a linha, depois veja seu código-fonte.

    SELECT pg_get_functiondef('debit_account'::regproc);
  2. Corrija os dados ou a chamada para que a regra seja satisfeita, ou altere a regra se ela estiver errada.

  3. Ao escrever tais verificações, dê a elas um código e um detalhe significativos para que os chamadores possam diferenciá-las.

    RAISE EXCEPTION 'insufficient funds for account %', p_account
        USING ERRCODE = 'check_violation',
              DETAIL = format('balance %s, requested %s', v_balance, p_amount);

Reproduza com segurança

DO $$ BEGIN RAISE EXCEPTION 'something went wrong'; END $$;  -- ERROR: something went wrong (SQLSTATE P0001)

Erros relacionados

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.