Codes d'erreur PostgreSQL
Tous les codes SQLSTATE que PostgreSQL peut générer, regroupés par classe comme dans l'annexe officielle. Ceux que les utilisateurs rencontrent réellement ont une page complète : ce que l'erreur signifie, pourquoi elle se produit et comment la corriger.
Lire une erreur PostgreSQL
PostgreSQL identifie chaque erreur par un code SQLSTATE à cinq caractères. Les deux premiers caractères représentent la classe : 23 est une violation de contrainte d'intégrité, 42 est une erreur de syntaxe ou une violation des règles d'accès, 40 est un rollback de transaction, et ainsi de suite. Les codes se terminant par 000 sont les codes génériques de leur classe.
psql affiche le message, pas le code. Exécutez \set VERBOSITY verbose pour voir le SQLSTATE, ou lisez-le depuis votre pilote : SQLSTATE avec JDBC et ODBC, e.pgcode dans psycopg2, e.sqlstate dans psycopg 3, err.code dans node-postgres.
En PL/pgSQL, vous pouvez intercepter une erreur par son nom de condition (EXCEPTION WHEN unique_violation THEN) ou par son code (WHEN SQLSTATE '23505' THEN).
Toutes les erreurs PostgreSQL dans cette référence
262 codes, dont 63 avec une explication complète (lien). Les codes et les messages proviennent de la Documentation PostgreSQL, annexe A : Codes d’erreur PostgreSQL.
Achèvement réussi
| Code | Sens |
|---|---|
00000
|
successful_completion
|
Avertissement
| Code | Sens |
|---|---|
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
|
Pas de données (c'est aussi une classe d'avertissement selon la norme SQL)
| Code | Sens |
|---|---|
02000
|
no_data
|
02001
|
no_additional_dynamic_result_sets_returned
|
Instruction SQL pas encore complète
| Code | Sens |
|---|---|
03000
|
sql_statement_not_yet_complete
|
Exception de connexion
| Code | Sens |
|---|---|
08000
|
connection_exception
|
08003
|
connection_does_not_exist
|
08006
|
échec de connexion
connection_failure
le serveur a fermé la connexion de manière inattendue Cela signifie probablement que le serveur a terminé de manière anormale avant ou pendant le traitement de la requête.
|
08001
|
impossible d'établir la connexion
sqlclient_unable_to_establish_sqlconnection
la connexion au serveur sur "db.example.com" (10.0.0.5), port 5432 a échoué : Connexion refusée Le serveur fonctionne-t-il sur cet hôte et accepte-t-il les connexions TCP/IP ?
|
08004
|
sqlserver_rejected_establishment_of_sqlconnection
|
08007
|
transaction_resolution_unknown
|
08P01
|
protocol_violation
|
Exception d’action déclenchée
| Code | Sens |
|---|---|
09000
|
triggered_action_exception
|
Fonctionnalité non prise en charge
| Code | Sens |
|---|---|
0A000
|
fonctionnalité non prise en charge
feature_not_supported
les références entre bases de données ne sont pas implémentées : "otherdb.public.orders"
|
Initialisation de transaction invalide
| Code | Sens |
|---|---|
0B000
|
invalid_transaction_initiation
|
Exception de localisateur
| Code | Sens |
|---|---|
0F000
|
locator_exception
|
0F001
|
invalid_locator_specification
|
Concédant invalide
| Code | Sens |
|---|---|
0L000
|
invalid_grantor
|
0LP01
|
opération GRANT non valide
invalid_grant_operation
les options de GRANT ne peuvent être accordées qu'aux rôles
|
Spécification de rôle invalide
| Code | Sens |
|---|---|
0P000
|
invalid_role_specification
|
Exception de diagnostic
| Code | Sens |
|---|---|
0Z000
|
diagnostics_exception
|
0Z002
|
stacked_diagnostics_accessed_without_active_handler
|
Erreur XQuery
| Code | Sens |
|---|---|
10608
|
invalid_argument_for_xquery
|
Cas non trouvé
| Code | Sens |
|---|---|
20000
|
case_not_found
|
Violation de cardinalité
| Code | Sens |
|---|---|
21000
|
plus d'une ligne retournée par une sous-requête
cardinality_violation
plus d'une ligne retournée par une sous-requête utilisée comme expression
|
Exception de données
| Code | Sens |
|---|---|
22000
|
data_exception
|
2202E
|
array_subscript_error
|
22021
|
séquence d'octets invalide pour l'encodage
character_not_in_repertoire
séquence d'octets invalide pour l'encodage "UTF8" : 0xff
|
22008
|
valeur de champ date/heure hors limites
datetime_field_overflow
valeur de champ date/heure hors limites : "2026-13-01"
|
22012
|
division par zéro
division_by_zero
division par zéro
|
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
|
format de date/heure invalide
invalid_datetime_format
syntaxe en entrée invalide pour le type 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
|
valeur de paramètre invalide
invalid_parameter_value
valeur invalide pour le paramètre "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
|
valeur numérique hors limites
numeric_value_out_of_range
entier hors limites
|
2200H
|
sequence_generator_limit_exceeded
|
22026
|
string_data_length_mismatch
|
22001
|
valeur trop longue pour le type
string_data_right_truncation
valeur trop longue pour le type character varying(20)
|
22011
|
substring_error
|
22027
|
trim_error
|
22024
|
unterminated_c_string
|
2200F
|
zero_length_character_string
|
22P01
|
floating_point_exception
|
22P02
|
syntaxe en entrée invalide pour le type
invalid_text_representation
syntaxe en entrée invalide pour le type 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
|
Violation de contrainte d'intégrité
| Code | Sens |
|---|---|
23000
|
integrity_constraint_violation
|
23001
|
restrict_violation
|
23502
|
valeur nulle enfreint la contrainte NOT NULL
not_null_violation
valeur nulle dans la colonne "email" de la relation "users" enfreint la contrainte NOT NULL DÉTAIL : La ligne échouée contient (7, Ada, null).
|
23503
|
violation de contrainte de clé étrangère
foreign_key_violation
insertion ou mise à jour sur la table "orders" viole la contrainte de clé étrangère "orders_customer_id_fkey" DÉTAIL : la clé (customer_id)=(42) n'est pas présente dans la table "customers".
|
23505
|
une clé dupliquée viole la contrainte unique
unique_violation
une valeur de clé dupliquée viole la contrainte unique "users_email_key" DÉTAIL : La clé (email)=([email protected]) existe déjà.
|
23514
|
violation de contrainte CHECK
check_violation
Nouvelle ligne pour la relation "orders" viole la contrainte de vérification "orders_qty_check" DÉTAIL : La ligne échouant contient (12, -1).
|
23P01
|
violation de contrainte d'exclusion
exclusion_violation
La valeur de la clé en conflit viole la contrainte d'exclusion "bookings_room_during_excl" DÉTAIL : La clé (room_id, during)=(4, ["2026-05-01 10:00:00","2026-05-01 11:00:00")) est en conflit avec la clé existante (room_id, during)=(4, ["2026-05-01 10:30:00","2026-05-01 12:00:00")).
|
État du curseur invalide
| Code | Sens |
|---|---|
24000
|
invalid_cursor_state
|
État de transaction invalide
| Code | Sens |
|---|---|
25000
|
invalid_transaction_state
|
25001
|
impossible d'exécuter dans un bloc de transaction
active_sql_transaction
CREATE INDEX CONCURRENTLY ne peut pas être exécuté dans un bloc de transaction
|
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
|
Transaction SQL en lecture seule
read_only_sql_transaction
impossible d'exécuter INSERT dans une transaction en lecture seule
|
25007
|
schema_and_data_statement_mixing_not_supported
|
25P01
|
no_active_sql_transaction
|
25P02
|
la transaction en cours est annulée
in_failed_sql_transaction
la transaction en cours est annulée, les commandes sont ignorées jusqu'à la fin du bloc de transaction
|
25P03
|
délai d'expiration des sessions inactives en transaction
idle_in_transaction_session_timeout
connexion interrompue en raison du délai d'inactivité dans la transaction
|
25P04
|
transaction_timeout
|
Nom d'instruction SQL invalide
| Code | Sens |
|---|---|
26000
|
invalid_sql_statement_name
|
Violation de modification de données déclenchée
| Code | Sens |
|---|---|
27000
|
triggered_data_change_violation
|
Spécification d'autorisation invalide
| Code | Sens |
|---|---|
28000
|
spécification d'autorisation invalide
invalid_authorization_specification
aucune entrée pg_hba.conf pour l'hôte "10.0.0.5", utilisateur "app", base de données "shop", pas de chiffrement
|
28P01
|
échec de l'authentification par mot de passe
invalid_password
échec de l'authentification par mot de passe pour l'utilisateur "app"
|
Descripteurs de privilèges dépendants encore existants
| Code | Sens |
|---|---|
2B000
|
dependent_privilege_descriptors_still_exist
|
2BP01
|
des objets dépendants existent encore
dependent_objects_still_exist
impossible de supprimer la table customers car d'autres objets en dépendent DÉTAIL : la contrainte orders_customer_id_fkey de la table orders dépend de la table customers ASTUCE : utilisez DROP ... CASCADE pour supprimer aussi les objets dépendants.
|
Fin de transaction invalide
| Code | Sens |
|---|---|
2D000
|
terminaison de transaction invalide
invalid_transaction_termination
terminaison de transaction invalide
|
Exception de routine SQL
| Code | Sens |
|---|---|
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
|
Nom de curseur invalide
| Code | Sens |
|---|---|
34000
|
invalid_cursor_name
|
Exception de routine externe
| Code | Sens |
|---|---|
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
|
Exception d'invocation de routine externe
| Code | Sens |
|---|---|
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
|
Exception de point de sauvegarde
| Code | Sens |
|---|---|
3B000
|
savepoint_exception
|
3B001
|
spécification de point de sauvegarde invalide
invalid_savepoint_specification
le point de sauvegarde "before_update" n'existe pas
|
Nom de catalogue invalide
| Code | Sens |
|---|---|
3D000
|
la base de données n'existe pas
invalid_catalog_name
la base de données "shop" n'existe pas
|
Nom de schéma invalide
| Code | Sens |
|---|---|
3F000
|
le schéma n'existe pas
invalid_schema_name
le schéma "sales" n'existe pas
|
Annulation de transaction
| Code | Sens |
|---|---|
40000
|
transaction_rollback
|
40002
|
transaction_integrity_constraint_violation
|
40001
|
impossible de sérialiser l'accès
serialization_failure
impossible de sérialiser l'accès en raison d'une mise à jour concurrente
|
40003
|
statement_completion_unknown
|
40P01
|
interblocage détecté
deadlock_detected
interblocage détecté DÉTAIL : Processus 1234 attend un ShareLock sur la transaction 5678 ; bloqué par le processus 4321. Processus 4321 attend un ShareLock sur la transaction 8765 ; bloqué par le processus 1234.
|
Erreur de syntaxe ou violation de règle d'accès
| Code | Sens |
|---|---|
42000
|
syntax_error_or_access_rule_violation
|
42601
|
erreur de syntaxe sur ou près de
syntax_error
erreur de syntaxe sur ou près de "FROM" LIGNE 1 : SELECT id, name, FROM users; ^
|
42501
|
permission refusée
insufficient_privilege
permission refusée pour la table orders
|
42846
|
impossible de convertir
cannot_coerce
impossible de convertir le type integer en uuid
|
42803
|
la colonne doit apparaître dans la clause GROUP BY
grouping_error
la colonne "o.customer_id" doit apparaître dans la clause GROUP BY ou être utilisée dans une fonction d'agrégation
|
42P20
|
windowing_error
|
42P19
|
invalid_recursion
|
42830
|
clé étrangère invalide
invalid_foreign_key
il n'y a pas de contrainte unique correspondant aux clés données pour la table référencée "customers"
|
42602
|
invalid_name
|
42622
|
name_too_long
|
42939
|
reserved_name
|
42804
|
incompatibilité de type de données
datatype_mismatch
la colonne "created_at" est de type timestamp with time zone, mais l'expression est de type integer ASTUCE : vous devrez réécrire ou convertir l'expression.
|
42P18
|
impossible de déterminer le type de données du paramètre
indeterminate_datatype
impossible de déterminer le type de données du paramètre $1
|
42P21
|
collation_mismatch
|
42P22
|
indeterminate_collation
|
42809
|
wrong_object_type
|
428C9
|
generated_always
|
42703
|
la colonne n'existe pas
undefined_column
la colonne "emial" n'existe pas LIGNE 1 : SELECT emial FROM users; ^ ASTUCE : vous vouliez peut-être référencer la colonne "users.email".
|
42883
|
la fonction n'existe pas
undefined_function
la fonction lower(integer) n'existe pas LIGNE 1 : SELECT lower(42); ^ ASTUCE : aucune fonction ne correspond au nom et aux types d'arguments donnés. Vous devrez peut-être ajouter des conversions de type explicites.
|
42P01
|
la relation n'existe pas
undefined_table
la relation "orders" n'existe pas LINE 1: SELECT * FROM orders; ^
|
42P02
|
il n'y a pas de paramètre
undefined_parameter
il n'y a pas de paramètre $1
|
42704
|
objet non défini
undefined_object
le type "jsonbb" n'existe pas
|
42701
|
duplicate_column
|
42P03
|
duplicate_cursor
|
42P04
|
la base de données existe déjà
duplicate_database
la base de données "shop" existe déjà
|
42723
|
duplicate_function
|
42P05
|
duplicate_prepared_statement
|
42P06
|
le schéma existe déjà
duplicate_schema
le schéma "sales" existe déjà
|
42P07
|
la relation existe déjà
duplicate_table
la relation "orders" existe déjà
|
42712
|
duplicate_alias
|
42710
|
objet dupliqué
duplicate_object
le rôle "app" existe déjà
|
42702
|
référence de colonne ambiguë
ambiguous_column
la référence de colonne "id" est ambiguë LIGNE 1 : SELECT id FROM orders JOIN customers ON customers.id = orders.customer_id; ^
|
42725
|
ambiguous_function
|
42P08
|
ambiguous_parameter
|
42P09
|
ambiguous_alias
|
42P10
|
référence de colonne invalide
invalid_column_reference
il n'y a pas de contrainte unique ou d'exclusion correspondant à la spécification 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
|
Violation de l'option WITH CHECK
| Code | Sens |
|---|---|
44000
|
with_check_option_violation
|
Ressources insuffisantes
| Code | Sens |
|---|---|
53000
|
insufficient_resources
|
53100
|
disque plein
disk_full
impossible d'étendre le fichier "base/16384/16397" : plus d'espace disponible sur le périphérique ASTUCE : Vérifiez l'espace disque disponible.
|
53200
|
Manque de mémoire
out_of_memory
Manque de mémoire DÉTAIL : échec de la demande de taille 1048576 dans le contexte mémoire "ExecutorState".
|
53300
|
trop de connexions
too_many_connections
désolé, trop de clients sont déjà connectés
|
53400
|
configuration_limit_exceeded
|
Limite du programme dépassée
| Code | Sens |
|---|---|
54000
|
limite de programme dépassée
program_limit_exceeded
la taille de ligne d'index 3200 dépasse le maximum de 2704 de la version 4 de btree pour l'index "documents_body_idx" DÉTAIL : la ligne de l'index référence le tuple (12,3) dans la relation "documents". ASTUCE : les valeurs plus grandes qu'un tiers d'une page tampon ne peuvent pas être indexées. Envisagez un index sur fonction du hachage MD5 de la valeur, ou utilisez l'indexation plein texte.
|
54001
|
statement_too_complex
|
54011
|
too_many_columns
|
54023
|
too_many_arguments
|
L'objet n'est pas dans l'état requis
| Code | Sens |
|---|---|
55000
|
objet pas dans l'état préalable
object_not_in_prerequisite_state
currval de la séquence "orders_id_seq" n'est pas encore défini dans cette session
|
55006
|
objet utilisé
object_in_use
la base de données "shop" est en cours d'utilisation par d'autres utilisateurs DÉTAIL : Il y a 1 autre session utilisant la base de données.
|
55P02
|
cant_change_runtime_param
|
55P03
|
verrou non disponible
lock_not_available
impossible d'obtenir le verrou sur la ligne dans la relation "orders"
|
55P04
|
unsafe_new_enum_value_usage
|
Intervention de l'opérateur
| Code | Sens |
|---|---|
57000
|
operator_intervention
|
57014
|
annulation de l'instruction
query_canceled
annulation de l'instruction en raison du délai d'expiration de l'instruction
|
57P01
|
connexion interrompue par l'administrateur
admin_shutdown
connexion interrompue sur commande de l'administrateur
|
57P02
|
crash_shutdown
|
57P03
|
impossible de se connecter maintenant
cannot_connect_now
le système de base de données est en cours de démarrage
|
57P04
|
database_dropped
|
57P05
|
idle_session_timeout
|
Erreur système (erreurs externes à PostgreSQL lui-même)
| Code | Sens |
|---|---|
58000
|
system_error
|
58030
|
io_error
|
58P01
|
fichier indéfini
undefined_file
impossible d'ouvrir le fichier "/tmp/orders.csv" pour lecture : Aucun fichier ou répertoire de ce type
|
58P02
|
duplicate_file
|
58P03
|
file_name_too_long
|
Erreur de fichier de configuration
| Code | Sens |
|---|---|
F0000
|
config_file_error
|
F0001
|
lock_file_exists
|
Erreur de wrapper de données externes (SQL/MED)
| Code | Sens |
|---|---|
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
|
Erreur PL/pgSQL
| Code | Sens |
|---|---|
P0000
|
plpgsql_error
|
P0001
|
générer une exception
raise_exception
fonds insuffisants pour le compte 42
|
P0002
|
no_data_found
|
P0003
|
too_many_rows
|
P0004
|
assert_failure
|
Erreur interne
| Code | Sens |
|---|---|
XX000
|
erreur interne
internal_error
échec de la consultation du cache pour la relation 16397
|
XX001
|
données corrompues
data_corrupted
page invalide dans le bloc 1234 de la relation base/16384/16397
|
XX002
|
index_corrupted
|
Autres bases de données
Une façon plus rapide de travailler avec PostgreSQL
SQLly est un client SQL natif pour macOS, Windows et Linux, avec un IntelliSense conscient du schéma et des garde-fous contre les instructions risquées.