Códigos de error de PostgreSQL
Todos los códigos SQLSTATE que PostgreSQL puede generar, agrupados por clase como en el apéndice oficial. Los que la gente realmente encuentra tienen una página completa: qué significa el error, por qué ocurre y cómo solucionarlo.
Leyendo un error de PostgreSQL
PostgreSQL identifica cada error con un código SQLSTATE de cinco caracteres. Los dos primeros caracteres indican la clase: 23 es violación de restricción de integridad, 42 es un error de sintaxis o una violación de regla de acceso, 40 es una reversión de transacción, y así sucesivamente. Los códigos que terminan en 000 son el código genérico de su clase.
psql muestra el mensaje, no el código. Ejecuta \set VERBOSITY verbose para ver el SQLSTATE, o léelo desde tu controlador: SQLSTATE en JDBC y ODBC, e.pgcode en psycopg2, e.sqlstate en psycopg 3, err.code en node-postgres.
En PL/pgSQL puedes capturar un error por el nombre de la condición (EXCEPTION WHEN unique_violation THEN) o por código (WHEN SQLSTATE '23505' THEN).
Todos los errores de PostgreSQL en esta referencia
262 códigos, 63 con una descripción completa (enlazada). Los códigos y mensajes son de la documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL.
Finalización con éxito
| Código | Significado |
|---|---|
00000
|
successful_completion
|
Advertencia
| Código | Significado |
|---|---|
01000
|
warning
|
0100C
|
dynamic_result_sets_returned
|
01008
|
implicit_zero_bit_padding
|
01003
|
null_value_eliminated_in_set_function
|
01007
|
privilege_not_granted
|
01006
|
privilege_not_revoked
|
01004
|
string_data_right_truncation
|
01P01
|
deprecated_feature
|
Sin Datos (esto también es una clase de advertencia según el estándar SQL)
| Código | Significado |
|---|---|
02000
|
no_data
|
02001
|
no_additional_dynamic_result_sets_returned
|
Instrucción SQL aún incompleta
| Código | Significado |
|---|---|
03000
|
sql_statement_not_yet_complete
|
Excepción de conexión
| Código | Significado |
|---|---|
08000
|
connection_exception
|
08003
|
connection_does_not_exist
|
08006
|
fallo de conexión
connection_failure
el servidor cerró la conexión inesperadamente Esto probablemente significa que el servidor terminó de manera anormal antes o mientras se procesaba la solicitud.
|
08001
|
no se pudo establecer la conexión
sqlclient_unable_to_establish_sqlconnection
la conexión con el servidor en "db.example.com" (10.0.0.5), puerto 5432 falló: Conexión rechazada ¿Está el servidor ejecutándose en ese host y aceptando conexiones TCP/IP?
|
08004
|
sqlserver_rejected_establishment_of_sqlconnection
|
08007
|
transaction_resolution_unknown
|
08P01
|
protocol_violation
|
Excepción de acción activada
| Código | Significado |
|---|---|
09000
|
triggered_action_exception
|
Función no admitida
| Código | Significado |
|---|---|
0A000
|
característica no admitida
feature_not_supported
las referencias entre bases de datos no están implementadas: "otherdb.public.orders"
|
Inicio de transacción no válido
| Código | Significado |
|---|---|
0B000
|
invalid_transaction_initiation
|
Excepción de localizador
| Código | Significado |
|---|---|
0F000
|
locator_exception
|
0F001
|
invalid_locator_specification
|
Otorgante no válido
| Código | Significado |
|---|---|
0L000
|
invalid_grantor
|
0LP01
|
operación de concesión no válida
invalid_grant_operation
las opciones de concesión solo se pueden otorgar a roles
|
Especificación de rol no válida
| Código | Significado |
|---|---|
0P000
|
invalid_role_specification
|
Excepción de diagnóstico
| Código | Significado |
|---|---|
0Z000
|
diagnostics_exception
|
0Z002
|
stacked_diagnostics_accessed_without_active_handler
|
Error de XQuery
| Código | Significado |
|---|---|
10608
|
invalid_argument_for_xquery
|
Caso no encontrado
| Código | Significado |
|---|---|
20000
|
case_not_found
|
Violación de cardinalidad
| Código | Significado |
|---|---|
21000
|
más de una fila devuelta por una subconsulta
cardinality_violation
más de una fila devuelta por una subconsulta utilizada como expresión
|
Excepción de datos
| Código | Significado |
|---|---|
22000
|
data_exception
|
2202E
|
array_subscript_error
|
22021
|
secuencia de bytes no válida para la codificación
character_not_in_repertoire
secuencia de bytes no válida para la codificación "UTF8": 0xff
|
22008
|
valor del campo fecha/hora fuera de rango
datetime_field_overflow
valor del campo fecha/hora fuera de rango: "2026-13-01"
|
22012
|
división por cero
division_by_zero
división por cero
|
22005
|
error_in_assignment
|
2200B
|
escape_character_conflict
|
22022
|
indicator_overflow
|
22015
|
interval_field_overflow
|
2201E
|
invalid_argument_for_logarithm
|
22014
|
invalid_argument_for_ntile_function
|
22016
|
invalid_argument_for_nth_value_function
|
2201F
|
invalid_argument_for_power_function
|
2201G
|
invalid_argument_for_width_bucket_function
|
22018
|
invalid_character_value_for_cast
|
22007
|
formato de fecha/hora no válido
invalid_datetime_format
sintaxis de entrada no válida para el tipo timestamp: "31/12/2026 25:00"
|
22019
|
invalid_escape_character
|
2200D
|
invalid_escape_octet
|
22025
|
invalid_escape_sequence
|
22P06
|
nonstandard_use_of_escape_character
|
22010
|
invalid_indicator_parameter_value
|
22023
|
valor de parámetro no válido
invalid_parameter_value
valor no válido para el parámetro "TimeZone": "Mars/Olympus"
|
22013
|
invalid_preceding_or_following_size
|
2201B
|
invalid_regular_expression
|
2201W
|
invalid_row_count_in_limit_clause
|
2201X
|
invalid_row_count_in_result_offset_clause
|
2202H
|
invalid_tablesample_argument
|
2202G
|
invalid_tablesample_repeat
|
22009
|
invalid_time_zone_displacement_value
|
2200C
|
invalid_use_of_escape_character
|
2200G
|
most_specific_type_mismatch
|
22004
|
null_value_not_allowed
|
22002
|
null_value_no_indicator_parameter
|
22003
|
valor numérico fuera de rango
numeric_value_out_of_range
entero fuera de rango
|
2200H
|
sequence_generator_limit_exceeded
|
22026
|
string_data_length_mismatch
|
22001
|
valor demasiado largo para el tipo
string_data_right_truncation
valor demasiado largo para el tipo character varying(20)
|
22011
|
substring_error
|
22027
|
trim_error
|
22024
|
unterminated_c_string
|
2200F
|
zero_length_character_string
|
22P01
|
floating_point_exception
|
22P02
|
sintaxis de entrada no válida para el tipo
invalid_text_representation
sintaxis de entrada no válida para el tipo integer: "abc"
|
22P03
|
invalid_binary_representation
|
22P04
|
bad_copy_file_format
|
22P05
|
untranslatable_character
|
2200L
|
not_an_xml_document
|
2200M
|
invalid_xml_document
|
2200N
|
invalid_xml_content
|
2200S
|
invalid_xml_comment
|
2200T
|
invalid_xml_processing_instruction
|
22030
|
duplicate_json_object_key_value
|
22031
|
invalid_argument_for_sql_json_datetime_function
|
22032
|
invalid_json_text
|
22033
|
invalid_sql_json_subscript
|
22034
|
more_than_one_sql_json_item
|
22035
|
no_sql_json_item
|
22036
|
non_numeric_sql_json_item
|
22037
|
non_unique_keys_in_a_json_object
|
22038
|
singleton_sql_json_item_required
|
22039
|
sql_json_array_not_found
|
2203A
|
sql_json_member_not_found
|
2203B
|
sql_json_number_not_found
|
2203C
|
sql_json_object_not_found
|
2203D
|
too_many_json_array_elements
|
2203E
|
too_many_json_object_members
|
2203F
|
sql_json_scalar_required
|
2203G
|
sql_json_item_cannot_be_cast_to_target_type
|
Violación de restricción de integridad
| Código | Significado |
|---|---|
23000
|
integrity_constraint_violation
|
23001
|
restrict_violation
|
23502
|
valor nulo viola la restricción de no nulo
not_null_violation
valor nulo en la columna "email" de la relación "users" viola la restricción de no nulo DETALLE: La fila que falla contiene (7, Ada, null).
|
23503
|
violación de restricción de clave foránea
foreign_key_violation
insertar o actualizar en la tabla "orders" viola la restricción de clave foránea "orders_customer_id_fkey" DETALLE: La clave (customer_id)=(42) no está presente en la tabla "customers".
|
23505
|
clave duplicada viola la restricción única
unique_violation
el valor de clave duplicada viola la restricción única "users_email_key" DETALLE: La clave (email)=([email protected]) ya existe.
|
23514
|
violación de la restricción CHECK
check_violation
nueva fila para la relación "orders" viola la restricción de comprobación "orders_qty_check" DETALLE: La fila que falla contiene (12, -1).
|
23P01
|
violación de la restricción de exclusión
exclusion_violation
valor de clave conflictivo viola la restricción de exclusión "bookings_room_during_excl" DETALLE: La clave (room_id, during)=(4, ["2026-05-01 10:00:00","2026-05-01 11:00:00")) entra en conflicto con la clave existente (room_id, during)=(4, ["2026-05-01 10:30:00","2026-05-01 12:00:00")).
|
Estado de cursor no válido
| Código | Significado |
|---|---|
24000
|
invalid_cursor_state
|
Estado de transacción no válido
| Código | Significado |
|---|---|
25000
|
invalid_transaction_state
|
25001
|
no se puede ejecutar dentro de un bloque de transacción
active_sql_transaction
CREATE INDEX CONCURRENTLY no se puede ejecutar dentro de un bloque de transacción
|
25002
|
branch_transaction_already_active
|
25008
|
held_cursor_requires_same_isolation_level
|
25003
|
inappropriate_access_mode_for_branch_transaction
|
25004
|
inappropriate_isolation_level_for_branch_transaction
|
25005
|
no_active_sql_transaction_for_branch_transaction
|
25006
|
transacción SQL de solo lectura
read_only_sql_transaction
no se puede ejecutar INSERT en una transacción de solo lectura
|
25007
|
schema_and_data_statement_mixing_not_supported
|
25P01
|
no_active_sql_transaction
|
25P02
|
la transacción actual está abortada
in_failed_sql_transaction
la transacción actual ha sido abortada, comandos ignorados hasta el fin del bloque de transacción
|
25P03
|
tiempo de espera de sesión inactiva en transacción
idle_in_transaction_session_timeout
terminando conexión debido a tiempo de espera de inactividad en transacción
|
25P04
|
transaction_timeout
|
Nombre de instrucción SQL no válido
| Código | Significado |
|---|---|
26000
|
invalid_sql_statement_name
|
Violación de cambio de datos activada
| Código | Significado |
|---|---|
27000
|
triggered_data_change_violation
|
Especificación de autorización no válida
| Código | Significado |
|---|---|
28000
|
especificación de autorización no válida
invalid_authorization_specification
no hay entrada en pg_hba.conf para el host "10.0.0.5", usuario "app", base de datos "shop", sin cifrado
|
28P01
|
fallo de autenticación de contraseña
invalid_password
password authentication failed for user "app"
|
Aún existen descriptores de privilegios dependientes
| Código | Significado |
|---|---|
2B000
|
dependent_privilege_descriptors_still_exist
|
2BP01
|
aún existen objetos dependientes
dependent_objects_still_exist
no se puede eliminar la tabla customers porque otros objetos dependen de ella DETALLE: la restricción orders_customer_id_fkey en la tabla orders depende de la tabla customers SUGERENCIA: Usa DROP ... CASCADE para eliminar también los objetos dependientes.
|
Terminación de transacción no válida
| Código | Significado |
|---|---|
2D000
|
terminación de transacción no válida
invalid_transaction_termination
terminación de transacción no válida
|
Excepción de Rutina SQL
| Código | Significado |
|---|---|
2F000
|
sql_routine_exception
|
2F005
|
function_executed_no_return_statement
|
2F002
|
modifying_sql_data_not_permitted
|
2F003
|
prohibited_sql_statement_attempted
|
2F004
|
reading_sql_data_not_permitted
|
Nombre de cursor no válido
| Código | Significado |
|---|---|
34000
|
invalid_cursor_name
|
Excepción de rutina externa
| Código | Significado |
|---|---|
38000
|
external_routine_exception
|
38001
|
containing_sql_not_permitted
|
38002
|
modifying_sql_data_not_permitted
|
38003
|
prohibited_sql_statement_attempted
|
38004
|
reading_sql_data_not_permitted
|
Excepción de invocación de rutina externa
| Código | Significado |
|---|---|
39000
|
external_routine_invocation_exception
|
39001
|
invalid_sqlstate_returned
|
39004
|
null_value_not_allowed
|
39P01
|
trigger_protocol_violated
|
39P02
|
srf_protocol_violated
|
39P03
|
event_trigger_protocol_violated
|
Excepción de punto de guardado
| Código | Significado |
|---|---|
3B000
|
savepoint_exception
|
3B001
|
especificación de savepoint no válida
invalid_savepoint_specification
el savepoint "before_update" no existe
|
Nombre de catálogo no válido
| Código | Significado |
|---|---|
3D000
|
la base de datos no existe
invalid_catalog_name
la base de datos "shop" no existe
|
Nombre de esquema no válido
| Código | Significado |
|---|---|
3F000
|
el esquema no existe
invalid_schema_name
el esquema "sales" no existe
|
Reversión de transacción
| Código | Significado |
|---|---|
40000
|
transaction_rollback
|
40002
|
transaction_integrity_constraint_violation
|
40001
|
no se pudo serializar el acceso
serialization_failure
no se pudo serializar el acceso debido a una actualización concurrente
|
40003
|
statement_completion_unknown
|
40P01
|
se detectó un interbloqueo
deadlock_detected
se detectó un interbloqueo DETALLE: El proceso 1234 espera un ShareLock en la transacción 5678; bloqueado por el proceso 4321. El proceso 4321 espera un ShareLock en la transacción 8765; bloqueado por el proceso 1234.
|
Error de sintaxis o violación de regla de acceso
| Código | Significado |
|---|---|
42000
|
syntax_error_or_access_rule_violation
|
42601
|
error de sintaxis en o cerca de
syntax_error
error de sintaxis en o cerca de "FROM" LÍNEA 1: SELECT id, name, FROM users; ^
|
42501
|
permiso denegado
insufficient_privilege
permission denied for table orders
|
42846
|
no se puede forzar
cannot_coerce
no se puede convertir el tipo integer a uuid
|
42803
|
la columna debe aparecer en la cláusula GROUP BY
grouping_error
la columna "o.customer_id" debe aparecer en la cláusula GROUP BY o usarse en una función de agregación
|
42P20
|
windowing_error
|
42P19
|
invalid_recursion
|
42830
|
clave foránea no válida
invalid_foreign_key
no existe una restricción única que coincida con las claves dadas para la tabla referenciada "customers"
|
42602
|
invalid_name
|
42622
|
name_too_long
|
42939
|
reserved_name
|
42804
|
incompatibilidad de tipos de datos
datatype_mismatch
la columna "created_at" es de tipo timestamp with time zone pero la expresión es de tipo integer SUGERENCIA: Tendrás que reescribir o convertir la expresión.
|
42P18
|
no se pudo determinar el tipo de datos del parámetro
indeterminate_datatype
no se pudo determinar el tipo de datos del parámetro $1
|
42P21
|
collation_mismatch
|
42P22
|
indeterminate_collation
|
42809
|
wrong_object_type
|
428C9
|
generated_always
|
42703
|
la columna no existe
undefined_column
la columna "emial" no existe LÍNEA 1: SELECT emial FROM users; ^ SUGERENCIA: Quizás querías referirte a la columna "users.email".
|
42883
|
la función no existe
undefined_function
función lower(integer) no existe LÍNEA 1: SELECT lower(42); ^ SUGERENCIA: Ninguna función coincide con el nombre y los tipos de argumento dados. Quizá necesites añadir conversiones de tipo explícitas.
|
42P01
|
la relación no existe
undefined_table
la relación "orders" no existe LÍNEA 1: SELECT * FROM orders; ^
|
42P02
|
no hay parámetro
undefined_parameter
no hay parámetro $1
|
42704
|
objeto indefinido
undefined_object
el tipo "jsonbb" no existe
|
42701
|
duplicate_column
|
42P03
|
duplicate_cursor
|
42P04
|
la base de datos ya existe
duplicate_database
la base de datos "shop" ya existe
|
42723
|
duplicate_function
|
42P05
|
duplicate_prepared_statement
|
42P06
|
el esquema ya existe
duplicate_schema
el esquema "sales" ya existe
|
42P07
|
la relación ya existe
duplicate_table
la relación "orders" ya existe
|
42712
|
duplicate_alias
|
42710
|
objeto duplicado
duplicate_object
el rol "app" ya existe
|
42702
|
la referencia de columna es ambigua
ambiguous_column
la referencia de columna "id" es ambigua LÍNEA 1: SELECT id FROM orders JOIN customers ON customers.id = orders.customer_id; ^
|
42725
|
ambiguous_function
|
42P08
|
ambiguous_parameter
|
42P09
|
ambiguous_alias
|
42P10
|
referencia de columna no válida
invalid_column_reference
no existe restricción única o de exclusión que coincida con la especificación ON CONFLICT
|
42611
|
invalid_column_definition
|
42P11
|
invalid_cursor_definition
|
42P12
|
invalid_database_definition
|
42P13
|
invalid_function_definition
|
42P14
|
invalid_prepared_statement_definition
|
42P15
|
invalid_schema_definition
|
42P16
|
invalid_table_definition
|
42P17
|
invalid_object_definition
|
Infracción de la opción WITH CHECK
| Código | Significado |
|---|---|
44000
|
with_check_option_violation
|
Recursos insuficientes
| Código | Significado |
|---|---|
53000
|
insufficient_resources
|
53100
|
disco lleno
disk_full
no se pudo ampliar el archivo "base/16384/16397": No queda espacio en el dispositivo SUGERENCIA: Comprueba el espacio libre en disco.
|
53200
|
memoria agotada
out_of_memory
out of memory DETAIL: Failed on request of size 1048576 in memory context "ExecutorState".
|
53300
|
demasiadas conexiones
too_many_connections
lo siento, ya hay demasiados clientes
|
53400
|
configuration_limit_exceeded
|
Límite del programa excedido
| Código | Significado |
|---|---|
54000
|
límite de programa excedido
program_limit_exceeded
el tamaño de la fila del índice 3200 excede el máximo de 2704 de la versión 4 de btree para el índice "documents_body_idx" DETALLE: La fila del índice hace referencia a la tupla (12,3) en la relación "documents". SUGERENCIA: Los valores mayores que 1/3 de una página de búfer no se pueden indexar. Considera un índice de función sobre un hash MD5 del valor, o usa la indexación de texto completo.
|
54001
|
statement_too_complex
|
54011
|
too_many_columns
|
54023
|
too_many_arguments
|
El objeto no está en el estado de prerrequisito
| Código | Significado |
|---|---|
55000
|
el objeto no está en el estado previo requerido
object_not_in_prerequisite_state
currval de la secuencia "orders_id_seq" aún no está definido en esta sesión
|
55006
|
objeto en uso
object_in_use
la base de datos "shop" está siendo accedida por otros usuarios DETALLE: Hay 1 sesión más utilizando la base de datos.
|
55P02
|
cant_change_runtime_param
|
55P03
|
bloqueo no disponible
lock_not_available
no se pudo obtener el bloqueo en la fila de la relación "orders"
|
55P04
|
unsafe_new_enum_value_usage
|
Intervención del operador
| Código | Significado |
|---|---|
57000
|
operator_intervention
|
57014
|
cancelando instrucción
query_canceled
cancelando instrucción debido al tiempo de espera de la instrucción
|
57P01
|
terminando conexión debido a administrador
admin_shutdown
terminando conexión debido a comando del administrador
|
57P02
|
crash_shutdown
|
57P03
|
no se puede conectar ahora
cannot_connect_now
el sistema de base de datos se está iniciando
|
57P04
|
database_dropped
|
57P05
|
idle_session_timeout
|
Error del sistema (errores externos a PostgreSQL en sí)
| Código | Significado |
|---|---|
58000
|
system_error
|
58030
|
io_error
|
58P01
|
archivo indefinido
undefined_file
no se pudo abrir el archivo "/tmp/orders.csv" para lectura: No existe dicho archivo o directorio
|
58P02
|
duplicate_file
|
58P03
|
file_name_too_long
|
Error de archivo de configuración
| Código | Significado |
|---|---|
F0000
|
config_file_error
|
F0001
|
lock_file_exists
|
Error del wrapper de datos externos (SQL/MED)
| Código | Significado |
|---|---|
HV000
|
fdw_error
|
HV005
|
fdw_column_name_not_found
|
HV002
|
fdw_dynamic_parameter_value_needed
|
HV010
|
fdw_function_sequence_error
|
HV021
|
fdw_inconsistent_descriptor_information
|
HV024
|
fdw_invalid_attribute_value
|
HV007
|
fdw_invalid_column_name
|
HV008
|
fdw_invalid_column_number
|
HV004
|
fdw_invalid_data_type
|
HV006
|
fdw_invalid_data_type_descriptors
|
HV091
|
fdw_invalid_descriptor_field_identifier
|
HV00B
|
fdw_invalid_handle
|
HV00C
|
fdw_invalid_option_index
|
HV00D
|
fdw_invalid_option_name
|
HV090
|
fdw_invalid_string_length_or_buffer_length
|
HV00A
|
fdw_invalid_string_format
|
HV009
|
fdw_invalid_use_of_null_pointer
|
HV014
|
fdw_too_many_handles
|
HV001
|
fdw_out_of_memory
|
HV00P
|
fdw_no_schemas
|
HV00J
|
fdw_option_name_not_found
|
HV00K
|
fdw_reply_handle
|
HV00Q
|
fdw_schema_not_found
|
HV00R
|
fdw_table_not_found
|
HV00L
|
fdw_unable_to_create_execution
|
HV00M
|
fdw_unable_to_create_reply
|
HV00N
|
fdw_unable_to_establish_connection
|
Error de PL/pgSQL
| Código | Significado |
|---|---|
P0000
|
plpgsql_error
|
P0001
|
generar excepción
raise_exception
fondos insuficientes para la cuenta 42
|
P0002
|
no_data_found
|
P0003
|
too_many_rows
|
P0004
|
assert_failure
|
Error interno
| Código | Significado |
|---|---|
XX000
|
error interno
internal_error
la búsqueda en caché falló para la relación 16397
|
XX001
|
datos corruptos
data_corrupted
página no válida en el bloque 1234 de la relación base/16384/16397
|
XX002
|
index_corrupted
|
Una forma más rápida de trabajar con PostgreSQL
SQLly es un cliente SQL nativo para macOS, Windows y Linux, con IntelliSense que entiende el esquema y protecciones frente a instrucciones peligrosas.