A todos los mensajes emitidos por el servidor de PostgreSQL se les asignan códigos de error de cinco caracteres que siguen las convenciones del estándar SQL para los códigos “SQLSTATE”. Las aplicaciones que necesitan saber qué condición de error ha ocurrido generalmente deberían comprobar el código de error, en lugar de analizar el mensaje de error textual. Es menos probable que los códigos de error cambien entre las versiones de PostgreSQL, y tampoco están sujetos a cambios debido a la localización (traducción) de los mensajes de error. Ten en cuenta que algunos, pero no todos, los códigos de error producidos por PostgreSQL están definidos por el estándar SQL; algunos códigos de error adicionales para condiciones no definidas por el estándar han sido inventados o tomados de otras bases de datos.

Según el estándar, los dos primeros caracteres de un código de error denotan una clase de errores, mientras que los tres últimos caracteres indican una condición específica dentro de esa clase. Por lo tanto, una aplicación que no reconozca el código de error específico aún podría inferir qué hacer a partir de la clase de error.

La Table A.1 enumera todos los códigos de error definidos en PostgreSQL 18.4. (Algunos no se usan realmente en la actualidad, pero están definidos por el estándar SQL). También se muestran las clases de error. Para cada clase de error hay un código de error “estándar” que tiene los tres últimos caracteres en 000. Este código se utiliza únicamente para condiciones de error que pertenecen a la clase pero que no tienen ningún código más específico asignado.

El símbolo que se muestra en la columna “Nombre de la condición” es el nombre de la condición que se debe usar en PL/pgSQL. Los nombres de las condiciones se pueden escribir tanto en mayúsculas como en minúsculas. (Ten en cuenta que PL/pgSQL no reconoce los nombres de condiciones de advertencia, a diferencia de los de error; esos pertenecen a las clases 00, 01 y 02).

Para algunos tipos de errores, el servidor reporta el nombre de un objeto de la base de datos (una tabla, columna de tabla, tipo de datos o restricción) asociado con el error; por ejemplo, el nombre de la restricción única que causó un error de unique_violation. Dichos nombres se proporcionan en campos separados del mensaje de informe de error para que las aplicaciones no tengan que intentar extraerlos del texto del mensaje legible por humanos, que podría estar localizado. A partir de PostgreSQL 9.3, la cobertura completa para esta característica existe solo para los errores en la clase SQLSTATE 23 (violación de restricción de integridad), pero es probable que esto se amplíe en el futuro.