Apêndice A. Códigos de erro do PostgreSQL

Toda mensagem emitida pelo servidor PostgreSQL possui um código de erro de cinco caracteres associado, que segue as convenções do padrão SQL para códigos de "SQLSTATE". Os aplicativos que precisam saber qual condição de erro ocorreu devem, normalmente, testar o código de erro em vez de analisar o texto da mensagem de erro. Os códigos de erro têm menos probabilidade de mudar entre versões do PostgreSQL e, também, não estão sujeitos a mudanças devido ao idioma das mensagens de erro (pt_BR, etc.). Deve ser observado que alguns códigos de erro gerados pelo PostgreSQL estão definidos no padrão SQL, mas não todos; alguns códigos de erro adicionais, para condições não definidas no padrão, foram criados ou tomados emprestado de outros gerenciadores de banco de dados.

De acordo com o padrão, os dois primeiros caracteres do código de erro denotam a classe do erro, enquanto os três últimos caracteres indicam uma condição específica dentro da classe. Portanto, um aplicativo que não reconhece um determinado código de erro ainda pode ser capaz de inferir o que fazer a partir da classe do erro.

A Tabela A-1 lista todos os códigos de erro definidos no PostgreSQL 8.0.0 (Na verdade alguns não são utilizados atualmente, mas são definidos pelo padrão SQL). As classes de erro também estão mostradas. Para cada classe de erro existe um código de erro "padrão", possuindo os três últimos caracteres iguais a 000. Este código é utilizado apenas para as condições de erro que se enquadram na classe, mas que não possuem nenhum código mais específico atribuído.

No PL/pgSQL o nome da condição associada ao código de erro é idêntico à frase mostrada na tabela, com espaços substituídos pelo caractere sublinhado. Por exemplo, o nome da condição associada ao código 22012, DIVISION BY ZERO, é DIVISION_BY_ZERO. Os nomes das condições podem ser escritos tanto com letras maiúscula quanto com letras minúsculas (Deve ser observado que o PL/pgSQL não reconhece os nomes das condições de advertência, que são as classes 00, 01 e 02, ao contrário dos erros).