PostgreSQL 服务器发出的所有消息都赋予了五个字符的错误代码,这些代码遵循SQL的 "SQLSTATE" 代码的习惯。需要知道发生 了什么错误条件的应用通常应该测试错误代码,而不是查看文本错误信息。这些错误代码轻易不会随着PostgreSQL的版本更新而修改, 并且一般也不会随着错误信息的本地化而发生修改。
根据标准,错误代码的头两个字符表示错误类别,而后三个字符表示在该 类别内特定的条件。因此,那些不能识别特定错误代码的应用仍然可以从错误类别中推断要做什么。
Table A-1 里面列出了 PostgreSQL 7.4 定义的所有错误代码。(有些实际上目前并没有使用,但是 SQL 标准定义了。) 错误类别也列出在此。对于每个错误类别都有个"标准"的错误代码, 它的最后三个字符是000。这个代码只用于那些落在该类别内, 但是没有赋予任何更准确的代码的错误条件
Table A-1. PostgreSQL 错误代码
错误代码 含义
00 类 成功完成
00000 成功完成
01 类 警告
01000 警告
0100C 警告,返回了动态结果
01008 警告,隐含补齐了零比特位
01003 警告,在集合函数里消除了空值
01004 警告,字串数据在右端截断
02 类 没有数据 --- 按照 SQL99 的要求,这也是警告类
02000 没有数据
02001 返回了没有附加动态结果集
03 类 SQL 语句尚未结束
03000 SQL 语句尚未结束
08 类 连接例外
08000 连接例外
08003 连接不存在
08006 连接失败
08001 SQL 客户端不能建立 SQL 连接
08004 SQL 服务器拒绝建立 SQL 连接
08007 未知的事务分辨率
08P01 违反协议
09 类 触发器动作列外
09000 触发的动作例外
0A 类 不支持特性
0A000 不支持此特性
0B 类 非法事务初始化
0B000 非法事务初始化
0F 类 指示器例外
0F000 指示器例外
0F001 非法的声明
0L 类 非法赋权人
0L000 非法赋权人
0LP01 非法赋权操作
0P 类 非法角色声明
0P000 非法角色声明
21 类 势违反
21000 势违反
22 类 数据例外
22000 数据例外
2202E 数组元素错误
22021 字符不在准备好的范围内
22008 日期时间字段溢出
22012 被零除
22005 赋值中出错
2200B 逃逸字符冲突
22022 指示器溢出
22015 内部字段溢出
22018 类型转换时非法的字符值
22007 非法日期时间格式
22019 非法的逃逸字符
2200D 非法的逃逸字节
22025 非法逃逸序列
22010 非法指示器参数值
22020 非法限制值
22023 非法参数值
2201B 非法正则表达式
22009 非法时区显示值
2200C 非法使用逃逸字符
2200G 最相关类型不匹配
22004 不允许 NULL 值
22002 NULL 只不能做指示器参数
22003 数字值超出范围
22026 字串数据长度不匹配
22001 字串数据右边被截断
22011 抽取子字串错误
22027 截断错误
22024 未结束的 C 字串
2200F 零长度的字符串
22P01 浮点例外
22P02 非法文本表现形式
22P03 非法二进制表现形式
22P04 错误的 COPY 格式
22P05 不可翻译字符
23 类 违反完整性约束
23000 违反完整性约束
23001 违反限制
23502 违反非空
23503 违反外键约束
23505 违反唯一约束
23514 违反检查
24 类 非法游标状态
24000 非法游标状态
25 类 非法事务状态
25000 非法事务状态
25001 活跃的 SQL 状态
25002 分支事务已经激活
25008 持有的游标要求同样的隔离级别
25003 对分支事务的不恰当的访问方式
25004 对分支事务的不恰当的隔离级别
25005 分支事务没有活跃的 SQL 事务
25006 只读的 SQL 事务
25007 不支持混和的模式和数据语句
25P01 没有活跃的 SQL 事务
25P02 在失败的 SQL 事务中
26 类 非法 SQL 语句名
26000 非法 SQL 语句名
27 类 违反触发的数据改变
27000 违反触发的数据改变
28 类 非法授权声明
28000 非法授权声明
2B 类 依然存在依赖的优先级描述符
2B000 依然存在依赖的优先级描述符
2BP01 依赖性对象仍然存在
2D 类 非法的事务终止
2D000 非法的事务终止
2F 类 SQL 过程例外
2F000 SQL 过程例外
2F005 执行的函数没有返回语句
2F002 不允许修改 SQL 数据
2F003 企图使用禁止的 SQL 语句
2F004 不允许读取 SQL 数据
34 类 非法游标名
34000 非法游标名
38 类 外部过程例外
38000 外部过程例外
38001 不允许包含的 SQL
38002 不允许修改 SQL 数据
38003 企图使用禁止的 SQL 语句
38004 不允许读取 SQL 数据
39 类 外部过程调用例外
39000 外部过程调用例外
39001 返回了非法的 SQLSTATE
39004 不允许空值
39P01 违反触发器协议
39P02 违反SRF协议
3D 类 非法数据库名
3D000 非法数据库名
3F 类 非法模式名
3F000 非法模式名
40 类 事务回滚
40000 事务回滚
40002 违反完整性约束
40001 串行化失败
40003 不知道语句是否结束
40P01 侦测到死锁
42 类 语法错误或者违反访问规则
42000 语法错误或者违反访问规则
42601 语法错误
42501 权限不够
42846 无法进行类型转换
42803 分组错误
42830 非法的外键
42602 非法名字
42622 名字太长
42939 保留名字
42804 数据类型不匹配
42P18 未决的数据类型
42809 错误的对象类型
42703 未定义的字段
42883 未定义的函数---字符字段=整数
42P01 未定义的表
42P02 未定义的参数
42704 未定义对象
42701 重复的字段
42P03 重复的游标
42P04 重复的数据库
42723 重复的函数
42P05 重复的语句
42P06 重复的模式
42P07 重复的表
42712 重复的别名
42710 重复的对象
42702 模糊的字段
42725 模糊的函数
42P08 模糊的参数
42P09 模糊的别名
42P10 非法字段引用
42611 非法字段定义
42P11 非法游标定义
42P12 非法的数据库定义
42P13 非法函数定义
42P14 非法语句定义
42P15 非法模式定义
42P16 非法表定义
42P17 非法对象定义
44 类 违反 WITH CHECK 选项
44000 违反 WITH CHECK 选项
53 类 资源不够
53000 资源不够
53100 磁盘满
53200 内存耗尽
53300 太多连接
54 类 超过程序限制
54000 超过程序限制
54001 语句太复杂
54011 太多字段
54023 参数太多
55 类 对象不在预先要求的状态
55000 对象不在预先要求的状态
55006 对象在使用中
55P02 无法修改运行时参数
57 类 操作者干涉
57000 操作者干涉
57014 查询被取消
57P01 管理员关机
57P02 崩溃关机
57P03 现在无法连接
58 类 系统错误( PostgreSQL 自己内部的错误)
58030 IO 错误
58P01 未定义的文件
58P02 重复的文件
F0 类 配置文件错误
F0000 配置文件错误
F0001 锁文件存在
XX 类 内部错误
XX000 内部错误
XX001 数据崩溃
XX002 索引崩溃
-201 (ECPG_TOO_MANY_ARGUMENTS)
这意味着你的命令声明了比命令预期要多的宿主变量(SQLSTATE 07001 或者 07002)
-202 (ECPG_TOO_FEW_ARGUMENTS)
这意味着你的命令声明了比命令预期要少的宿主变量(SQLSTATE 07001 或者 07002)
Error Code Meaning Condition Name
Class 00 — Successful Completion
00000 SUCCESSFUL COMPLETION successful_completion
Class 01 — Warning
01000 WARNING warning
0100C DYNAMIC RESULT SETS RETURNED dynamic_result_sets_returned
01008 IMPLICIT ZERO BIT PADDING implicit_zero_bit_padding
01003 NULL VALUE ELIMINATED IN SET FUNCTION null_value_eliminated_in_set_function
01007 PRIVILEGE NOT GRANTED privilege_not_granted
01006 PRIVILEGE NOT REVOKED privilege_not_revoked
01004 STRING DATA RIGHT TRUNCATION string_data_right_truncation
01P01 DEPRECATED FEATURE deprecated_feature
Class 02 — No Data (this is also a warning class per the SQL standard)
02000 NO DATA no_data
02001 NO ADDITIONAL DYNAMIC RESULT SETS RETURNED no_additional_dynamic_result_sets_returned
Class 03 — SQL Statement Not Yet Complete
03000 SQL STATEMENT NOT YET COMPLETE sql_statement_not_yet_complete
Class 08 — Connection Exception
08000 CONNECTION EXCEPTION connection_exception
08003 CONNECTION DOES NOT EXIST connection_does_not_exist
08006 CONNECTION FAILURE connection_failure
08001 SQLCLIENT UNABLE TO ESTABLISH SQLCONNECTION sqlclient_unable_to_establish_sqlconnection
08004 SQLSERVER REJECTED ESTABLISHMENT OF SQLCONNECTION sqlserver_rejected_establishment_of_sqlconnection
08007 TRANSACTION RESOLUTION UNKNOWN transaction_resolution_unknown
08P01 PROTOCOL VIOLATION protocol_violation
Class 09 — Triggered Action Exception
09000 TRIGGERED ACTION EXCEPTION triggered_action_exception
Class 0A — Feature Not Supported
0A000 FEATURE NOT SUPPORTED feature_not_supported
Class 0B — Invalid Transaction Initiation
0B000 INVALID TRANSACTION INITIATION invalid_transaction_initiation
Class 0F — Locator Exception
0F000 LOCATOR EXCEPTION locator_exception
0F001 INVALID LOCATOR SPECIFICATION invalid_locator_specification
Class 0L — Invalid Grantor
0L000 INVALID GRANTOR invalid_grantor
0LP01 INVALID GRANT OPERATION invalid_grant_operation
Class 0P — Invalid Role Specification
0P000 INVALID ROLE SPECIFICATION invalid_role_specification
Class 20 — Case Not Found
20000 CASE NOT FOUND case_not_found
Class 21 — Cardinality Violation
21000 CARDINALITY VIOLATION cardinality_violation
Class 22 — Data Exception
22000 DATA EXCEPTION data_exception
2202E ARRAY SUBSCRIPT ERROR array_subscript_error
22021 CHARACTER NOT IN REPERTOIRE character_not_in_repertoire
22008 DATETIME FIELD OVERFLOW datetime_field_overflow
22012 DIVISION BY ZERO division_by_zero
22005 ERROR IN ASSIGNMENT error_in_assignment
2200B ESCAPE CHARACTER CONFLICT escape_character_conflict
22022 INDICATOR OVERFLOW indicator_overflow
22015 INTERVAL FIELD OVERFLOW interval_field_overflow
2201E INVALID ARGUMENT FOR LOGARITHM invalid_argument_for_logarithm
22014 INVALID ARGUMENT FOR NTILE FUNCTION invalid_argument_for_ntile_function
22016 INVALID ARGUMENT FOR NTH_VALUE FUNCTION invalid_argument_for_nth_value_function
2201F INVALID ARGUMENT FOR POWER FUNCTION invalid_argument_for_power_function
2201G INVALID ARGUMENT FOR WIDTH BUCKET FUNCTION invalid_argument_for_width_bucket_function
22018 INVALID CHARACTER VALUE FOR CAST invalid_character_value_for_cast
22007 INVALID DATETIME FORMAT invalid_datetime_format
22019 INVALID ESCAPE CHARACTER invalid_escape_character
2200D INVALID ESCAPE OCTET invalid_escape_octet
22025 INVALID ESCAPE SEQUENCE invalid_escape_sequence
22P06 NONSTANDARD USE OF ESCAPE CHARACTER nonstandard_use_of_escape_character
22010 INVALID INDICATOR PARAMETER VALUE invalid_indicator_parameter_value
22023 INVALID PARAMETER VALUE invalid_parameter_value
2201B INVALID REGULAR EXPRESSION invalid_regular_expression
2201W INVALID ROW COUNT IN LIMIT CLAUSE invalid_row_count_in_limit_clause
2201X INVALID ROW COUNT IN RESULT OFFSET CLAUSE invalid_row_count_in_result_offset_clause
22009 INVALID TIME ZONE DISPLACEMENT VALUE invalid_time_zone_displacement_value
2200C INVALID USE OF ESCAPE CHARACTER invalid_use_of_escape_character
2200G MOST SPECIFIC TYPE MISMATCH most_specific_type_mismatch
22004 NULL VALUE NOT ALLOWED null_value_not_allowed
22002 NULL VALUE NO INDICATOR PARAMETER null_value_no_indicator_parameter
22003 NUMERIC VALUE OUT OF RANGE numeric_value_out_of_range
22026 STRING DATA LENGTH MISMATCH string_data_length_mismatch
22001 STRING DATA RIGHT TRUNCATION string_data_right_truncation
22011 SUBSTRING ERROR substring_error
22027 TRIM ERROR trim_error
22024 UNTERMINATED C STRING unterminated_c_string
2200F ZERO LENGTH CHARACTER STRING zero_length_character_string
22P01 FLOATING POINT EXCEPTION floating_point_exception
22P02 invalid_text_representation
22P03 INVALID BINARY REPRESENTATION invalid_binary_representation
22P04 BAD COPY FILE FORMAT bad_copy_file_format
22P05 UNTRANSLATABLE CHARACTER untranslatable_character
2200L NOT AN XML DOCUMENT not_an_xml_document
2200M INVALID XML DOCUMENT invalid_xml_document
2200N INVALID XML CONTENT invalid_xml_content
2200S INVALID XML COMMENT invalid_xml_comment
2200T INVALID XML PROCESSING INSTRUCTION invalid_xml_processing_instruction
Class 23 — Integrity Constraint Violation
23000 INTEGRITY CONSTRAINT VIOLATION integrity_constraint_violation
23001 RESTRICT VIOLATION restrict_violation
23502 NOT NULL VIOLATION not_null_violation
23503 FOREIGN KEY VIOLATION foreign_key_violation
23505 UNIQUE VIOLATION unique_violation
23514 CHECK VIOLATION check_violation
Class 24 — Invalid Cursor State
24000 INVALID CURSOR STATE invalid_cursor_state
Class 25 — Invalid Transaction State
25000 INVALID TRANSACTION STATE invalid_transaction_state
25001 ACTIVE SQL TRANSACTION active_sql_transaction
25002 BRANCH TRANSACTION ALREADY ACTIVE branch_transaction_already_active
25008 HELD CURSOR REQUIRES SAME ISOLATION LEVEL held_cursor_requires_same_isolation_level
25003 INAPPROPRIATE ACCESS MODE FOR BRANCH TRANSACTION inappropriate_access_mode_for_branch_transaction
25004 INAPPROPRIATE ISOLATION LEVEL FOR BRANCH TRANSACTION inappropriate_isolation_level_for_branch_transaction
25005 NO ACTIVE SQL TRANSACTION FOR BRANCH TRANSACTION no_active_sql_transaction_for_branch_transaction
25006 READ ONLY SQL TRANSACTION read_only_sql_transaction
25007 SCHEMA AND DATA STATEMENT MIXING NOT SUPPORTED schema_and_data_statement_mixing_not_supported
25P01 NO ACTIVE SQL TRANSACTION no_active_sql_transaction
25P02 IN FAILED SQL TRANSACTION in_failed_sql_transaction
Class 26 — Invalid SQL Statement Name
26000 INVALID SQL STATEMENT NAME invalid_sql_statement_name
Class 27 — Triggered Data Change Violation
27000 TRIGGERED DATA CHANGE VIOLATION triggered_data_change_violation
Class 28 — Invalid Authorization Specification
28000 INVALID AUTHORIZATION SPECIFICATION invalid_authorization_specification
Class 2B — Dependent Privilege Descriptors Still Exist
2B000 DEPENDENT PRIVILEGE DESCRIPTORS STILL EXIST dependent_privilege_descriptors_still_exist
2BP01 DEPENDENT OBJECTS STILL EXIST dependent_objects_still_exist
Class 2D — Invalid Transaction Termination
2D000 INVALID TRANSACTION TERMINATION invalid_transaction_termination
Class 2F — SQL Routine Exception
2F000 SQL ROUTINE EXCEPTION sql_routine_exception
2F005 FUNCTION EXECUTED NO RETURN STATEMENT function_executed_no_return_statement
2F002 MODIFYING SQL DATA NOT PERMITTED modifying_sql_data_not_permitted
2F003 PROHIBITED SQL STATEMENT ATTEMPTED prohibited_sql_statement_attempted
2F004 READING SQL DATA NOT PERMITTED reading_sql_data_not_permitted
Class 34 — Invalid Cursor Name
34000 INVALID CURSOR NAME invalid_cursor_name
Class 38 — External Routine Exception
38000 EXTERNAL ROUTINE EXCEPTION external_routine_exception
38001 CONTAINING SQL NOT PERMITTED containing_sql_not_permitted
38002 MODIFYING SQL DATA NOT PERMITTED modifying_sql_data_not_permitted
38003 PROHIBITED SQL STATEMENT ATTEMPTED prohibited_sql_statement_attempted
38004 READING SQL DATA NOT PERMITTED reading_sql_data_not_permitted
Class 39 — External Routine Invocation Exception
39000 EXTERNAL ROUTINE INVOCATION EXCEPTION external_routine_invocation_exception
39001 INVALID SQLSTATE RETURNED invalid_sqlstate_returned
39004 NULL VALUE NOT ALLOWED null_value_not_allowed
39P01 TRIGGER PROTOCOL VIOLATED trigger_protocol_violated
39P02 SRF PROTOCOL VIOLATED srf_protocol_violated
Class 3B — Savepoint Exception
3B000 SAVEPOINT EXCEPTION savepoint_exception
3B001 INVALID SAVEPOINT SPECIFICATION invalid_savepoint_specification
Class 3D — Invalid Catalog Name
3D000 INVALID CATALOG NAME invalid_catalog_name
Class 3F — Invalid Schema Name
3F000 INVALID SCHEMA NAME invalid_schema_name
Class 40 — Transaction Rollback
40000 TRANSACTION ROLLBACK transaction_rollback
40002 TRANSACTION INTEGRITY CONSTRAINT VIOLATION transaction_integrity_constraint_violation
40001 SERIALIZATION FAILURE serialization_failure
40003 STATEMENT COMPLETION UNKNOWN statement_completion_unknown
40P01 DEADLOCK DETECTED deadlock_detected
Class 42 — Syntax Error or Access Rule Violation
42000 SYNTAX ERROR OR ACCESS RULE VIOLATION syntax_error_or_access_rule_violation
42601 SYNTAX ERROR syntax_error
42501 INSUFFICIENT PRIVILEGE insufficient_privilege
42846 CANNOT COERCE cannot_coerce
42803 GROUPING ERROR grouping_error
42P20 WINDOWING ERROR windowing_error
42P19 INVALID RECURSION invalid_recursion
42830 INVALID FOREIGN KEY invalid_foreign_key
42602 INVALID NAME invalid_name
42622 NAME TOO LONG name_too_long
42939 RESERVED NAME reserved_name
42804 DATATYPE MISMATCH datatype_mismatch
42P18 INDETERMINATE DATATYPE indeterminate_datatype
42809 WRONG OBJECT TYPE wrong_object_type
42703 UNDEFINED COLUMN undefined_column
42883 UNDEFINED FUNCTION undefined_function
42P01 UNDEFINED TABLE undefined_table
42P02 UNDEFINED PARAMETER undefined_parameter
42704 UNDEFINED OBJECT undefined_object
42701 DUPLICATE COLUMN duplicate_column
42P03 DUPLICATE CURSOR duplicate_cursor
42P04 DUPLICATE DATABASE duplicate_database
42723 DUPLICATE FUNCTION duplicate_function
42P05 DUPLICATE PREPARED STATEMENT duplicate_prepared_statement
42P06 DUPLICATE SCHEMA duplicate_schema
42P07 DUPLICATE TABLE duplicate_table
42712 DUPLICATE ALIAS duplicate_alias
42710 DUPLICATE OBJECT duplicate_object
42702 AMBIGUOUS COLUMN ambiguous_column
42725 AMBIGUOUS FUNCTION ambiguous_function
42P08 AMBIGUOUS PARAMETER ambiguous_parameter
42P09 AMBIGUOUS ALIAS ambiguous_alias
42P10 INVALID COLUMN REFERENCE invalid_column_reference
42611 INVALID COLUMN DEFINITION invalid_column_definition
42P11 INVALID CURSOR DEFINITION invalid_cursor_definition
42P12 INVALID DATABASE DEFINITION invalid_database_definition
42P13 INVALID FUNCTION DEFINITION invalid_function_definition
42P14 INVALID PREPARED STATEMENT DEFINITION invalid_prepared_statement_definition
42P15 INVALID SCHEMA DEFINITION invalid_schema_definition
42P16 INVALID TABLE DEFINITION invalid_table_definition
42P17 INVALID OBJECT DEFINITION invalid_object_definition
Class 44 — WITH CHECK OPTION Violation
44000 WITH CHECK OPTION VIOLATION with_check_option_violation
Class 53 — Insufficient Resources
53000 INSUFFICIENT RESOURCES insufficient_resources
53100 DISK FULL disk_full
53200 OUT OF MEMORY out_of_memory
53300 TOO MANY CONNECTIONS too_many_connections
Class 54 — Program Limit Exceeded
54000 PROGRAM LIMIT EXCEEDED program_limit_exceeded
54001 STATEMENT TOO COMPLEX statement_too_complex
54011 TOO MANY COLUMNS too_many_columns
54023 TOO MANY ARGUMENTS too_many_arguments
Class 55 — Object Not In Prerequisite State
55000 OBJECT NOT IN PREREQUISITE STATE object_not_in_prerequisite_state
55006 OBJECT IN USE object_in_use
55P02 CANT CHANGE RUNTIME PARAM cant_change_runtime_param
55P03 LOCK NOT AVAILABLE lock_not_available
Class 57 — Operator Intervention
57000 OPERATOR INTERVENTION operator_intervention
57014 QUERY CANCELED query_canceled
57P01 ADMIN SHUTDOWN admin_shutdown
57P02 CRASH SHUTDOWN crash_shutdown
57P03 CANNOT CONNECT NOW cannot_connect_now
Class 58 — System Error (errors external to PostgreSQL itself)
58030 IO ERROR io_error
58P01 UNDEFINED FILE undefined_file
58P02 DUPLICATE FILE duplicate_file
Class F0 — Configuration File Error
F0000 CONFIG FILE ERROR config_file_error
F0001 LOCK FILE EXISTS lock_file_exists
Class P0 — PL/pgSQL Error
P0000 PLPGSQL ERROR plpgsql_error
P0001 RAISE EXCEPTION raise_exception
P0002 NO DATA FOUND no_data_found
P0003 TOO MANY ROWS too_many_rows
Class XX — Internal Error
XX000 INTERNAL ERROR internal_error
XX001 DATA CORRUPTED data_corrupted
XX002 INDEX CORRUPTED index_corrupted