Appendix A. PostgreSQL错误代码

PostgreSQL服务器发出的所有消息都赋予 了五个字符的错误代码,这些代码遵循 SQL 的"SQLSTATE" 代码的习惯。需要知道发生了什么错误条件的应用通常应该测试错误代码, 而不是查看文本错误信息。这些错误代码轻易不会随着PostgreSQL 的版本更新而修改,并且一般也不会随着错误信息的本地化而发生修改。 请注意有些(但不是全部)PostgreSQL生成的错误代码是 由 SQL 标准定义的;有些标准没有定义的错误条件是发明的或者是从其它数据库借来的。

根据标准,错误代码的头两个字符表示错误类别, 而后三个字符表示在该类别内特定的条件。因此, 那些不能识别特定错误代码的应用仍然可以从错误类别中推断要做什么。

Table A-1里面列出了PostgreSQL 8.2.3 定义的所有错误代码(有些实际上目前并没有使用, 但是 SQL 标准定义了)。错误类别也列出在此。对于每个错误类别都有个 "标准"的错误代码,它的最后三个字符是000。 这个代码只用于那些落在该类别内,但是没有赋予任何更准确的代码的错误条件。

PL/pgSQL用于每个错误代码的条件名和表中显示的措辞相同, 只是用下划线代替了空白。比如,代码22012, DIVISION BY ZERO 的条件名是DIVISION_BY_ZERO。 条件名大小写无关。(请注意PL/pgSQL并不识别警告,这一点和错误、条件名正相反;那些是 00, 01, 02 类别。)

Table A-1. PostgreSQL 错误代码

错误代码含义常量名
Class 00 — 成功完成
00000成功完成successful_completion
Class 01 — 警告
01000警告warning
0100C返回了动态结果dynamic_result_sets_returned
01008警告,隐含补齐了零比特位implicit_zero_bit_padding
01003在集合函数里消除nullnull_value_eliminated_in_set_function
01007没有赋予权限privilege_not_granted
01006没有撤销权限privilege_not_revoked
01004字符串数据在右端截断string_data_right_truncation
01P01废弃的特性deprecated_feature
Class 02 — 没有数据(按照 SQL 标准的要求,这也是警告类)
02000没有数据no_data
02001返回了没有附加动态结果集no_additional_dynamic_result_sets_returned
Class 03 — SQL语句尚未结束
03000SQL语句尚未结束sql_statement_not_yet_complete
Class 08 — 连接异常
08000连接异常connection_exception
08003连接不存在connection_does_not_exist
08006连接失败connection_failure
08001SQL 客户端不能建立 SQL 连接sqlclient_unable_to_establish_sqlconnection
08004SQL 服务器拒绝建立 SQL 连接sqlserver_rejected_establishment_of_sqlconnection
08007未知的事务解析transaction_resolution_unknown
08P01违反协议protocol_violation
Class 09 — Triggered Action Exception触发器动作异常
09000触发器动作异常triggered_action_exception
Class 0A — 不支持特性
0A000不支持此特性feature_not_supported
Class 0B — 非法事务初始化
0B000非法事务初始化invalid_transaction_initiation
Class 0F — 定位器异常
0F000定位器异常locator_exception
0F001非法的定位器声明invalid_locator_specification
Class 0L — 非法赋权者
0L000非法赋权者invalid_grantor
0LP01非法赋权操作invalid_grant_operation
Class 0P — 非法角色声明
0P000非法角色声明invalid_role_specification
Class 20 — 未发现情况
20000未发现情况case_not_found
Class 21 — 势违例
21000势违例cardinality_violation
Class 22 — 数据异常
22000数据异常data_exception
2202E数组下标错误array_subscript_error
22021字符不在规定范围内character_not_in_repertoire
22008日期时间字段溢出datetime_field_overflow
22012被零除division_by_zero
22005赋值中出错error_in_assignment
2200B逃逸字符冲突escape_character_conflict
22022INDICATOR OVERFLOW指示器溢出indicator_overflow
22015内部字段溢出interval_field_overflow
2201E对数运算的非法参数invalid_argument_for_logarithm
22014NTILE函数的无效参数invalid_argument_for_ntile_function
22016N倍函数的无效参数invalid_argument_for_nth_value_function
2201F指数函数的无效参数invalid_argument_for_power_function
2201GBUCKET函数的非法参数invalid_argument_for_width_bucket_function
22018类型转换时非法的字符值invalid_character_value_for_cast
22007非法日期时间格式invalid_datetime_format
22019非法的逃逸字符invalid_escape_character
2200D非法的逃逸字节invalid_escape_octet
22025非法逃逸序列invalid_escape_sequence
22P06非标准使用逃逸字符nonstandard_use_of_escape_character
22010非法指示器参数值invalid_indicator_parameter_value
22023非法参数值invalid_parameter_value
2201B非法正则表达式invalid_regular_expression
2201W无效的行数限制invalid_row_count_in_limit_clause
2201X在结果抵消子句中无效的行数invalid_row_count_in_result_offset_clause
22009非法时区显示值invalid_time_zone_displacement_value
2200C逃逸字符的非法使用invalid_use_of_escape_character
2200G最相关类型不匹配most_specific_type_mismatch
22004不允许 NULL 值null_value_not_allowed
22002NULL 值不能做指示器参数null_value_no_indicator_parameter
22003数字值超出范围numeric_value_out_of_range
22026字符串数据长度不匹配string_data_length_mismatch
22001字符串数据右边被截断string_data_right_truncation
22011抽取子字符串错误substring_error
22027截断错误trim_error
22024未结束的 C 字符串unterminated_c_string
2200F零长度的字符串zero_length_character_string
22P01浮点异常floating_point_exception
22P02非法文本表现形式invalid_text_representation
22P03非法二进制表现形式invalid_binary_representation
22P04错误的COPY文件格式bad_copy_file_format
22P05不可翻译字符untranslatable_character
2200L不是一个XML文档not_an_xml_document
2200M无效的XML文档invalid_xml_document
2200N无效的XML内容invalid_xml_content
2200S无效的XML评论invalid_xml_comment
2200T无效的XML处理指令invalid_xml_processing_instruction
Class 23 — 违反完整性约束
23000违反完整性约束integrity_constraint_violation
23001约束限制restrict_violation
23502NOT NULL VIOLATION违反非空not_null_violation
23503违反外键约束foreign_key_violation
23505违反唯一约束unique_violation
23514违反检查check_violation
23P01违反排除exclusion_violation
Class 24 — 非法游标状态
24000非法游标状态invalid_cursor_state
Class 25 — 非法事务状态
25000非法事务状态invalid_transaction_state
25001活跃的SQL状态active_sql_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分支事务没有活跃的SQL事务no_active_sql_transaction_for_branch_transaction
25006只读的SQL事务read_only_sql_transaction
25007不支持混和的模式和数据语句schema_and_data_statement_mixing_not_supported
25P01没有活跃的SQL事务no_active_sql_transaction
25P02在失败的SQL事务中in_failed_sql_transaction
Class 26 — 非法SQL语句名
26000非法SQL语句名invalid_sql_statement_name
Class 27 — 触发数据更改违规
27000触发数据更改违规triggered_data_change_violation
Class 28 — 非法授权声明
28000非法授权声明invalid_authorization_specification
28P01非法密码invalid_password
Class 2B — 依然存在依赖的优先级描述符
2B000依然存在依赖的优先级描述符dependent_privilege_descriptors_still_exist
2BP01依赖性对象仍然存在dependent_objects_still_exist
Class 2D — 非法的事务终止
2D000非法的事务终止invalid_transaction_termination
Class 2F — SQL过程异常
2F000SQL过程异常sql_routine_exception
2F005执行的函数没有返回语句function_executed_no_return_statement
2F002不允许修改SQL数据modifying_sql_data_not_permitted
2F003企图使用禁止的SQL语句prohibited_sql_statement_attempted
2F004不允许读取SQL数据reading_sql_data_not_permitted
Class 34 — 非法指针名
34000非法指针名invalid_cursor_name
Class 38 — 外部过程异常
38000外部过程异常external_routine_exception
38001不允许包含的SQLcontaining_sql_not_permitted
38002不允许修改SQL数据modifying_sql_data_not_permitted
38003企图使用禁止的SQL语句prohibited_sql_statement_attempted
38004不允许读取SQL数据reading_sql_data_not_permitted
Class 39 — 外部过程调用异常
39000外部过程调用异常external_routine_invocation_exception
39001返回了非法的SQL状态invalid_sqlstate_returned
39004不允许使用NULLnull_value_not_allowed
39P01违反触发器协议trigger_protocol_violated
39P02违反 SRF 协议srf_protocol_violated
Class 3B — 保存点异常
3B000保存点异常savepoint_exception
3B001无效的保存点声明invalid_savepoint_specification
Class 3D — 非法目录名
3D000非法目录名invalid_catalog_name
Class 3F — 非法模式名
3F000非法模式名invalid_schema_name
Class 40 — 事务回滚
40000事务回滚transaction_rollback
40002违反事务完整性约束transaction_integrity_constraint_violation
40001串行化失败serialization_failure
40003不知道语句是否结束statement_completion_unknown
40P01侦测到死锁deadlock_detected
Class 42 — 语法错误或者违反访问规则
42000语法错误或者违反访问规则syntax_error_or_access_rule_violation
42601语法错误syntax_error
42501权限不够insufficient_privilege
42846无法进行类型转换cannot_coerce
42803分组错误grouping_error
42P20开窗口错误windowing_error
42P19非法递归invalid_recursion
42830非法的外键invalid_foreign_key
42602非法名称invalid_name
42622名称过长name_too_long
42939保留名称reserved_name
42804数据类型不匹配datatype_mismatch
42P18模糊数据类型indeterminate_datatype
42809错误的对象类型wrong_object_type
42703未定义的字段undefined_column
42883未定义的函数undefined_function
42P01未定义的表undefined_table
42P02未定义的参数undefined_parameter
42704未定义对象undefined_object
42701重复的字段duplicate_column
42P03重复的游标duplicate_cursor
42P04重复的数据库duplicate_database
42723重复的函数duplicate_function
42P05重复的预备语句duplicate_prepared_statement
42P06重复的模式duplicate_schema
42P07重复的表duplicate_table
42712重复的别名duplicate_alias
42710重复的对象duplicate_object
42702模糊的字段ambiguous_column
42725模糊的函数ambiguous_function
42P08模糊的参数ambiguous_parameter
42P09模糊的别名ambiguous_alias
42P10非法字段引用invalid_column_reference
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
Class 44 — 违反 WITH CHECK 选项
44000违反 WITH CHECK 选项with_check_option_violation
Class 53 — 资源不够
53000资源不够insufficient_resources
53100磁盘满disk_full
53200内存耗尽out_of_memory
53300太多连接too_many_connections
Class 54 — 过多的程序限制
54000过多的程序限制program_limit_exceeded
54001语句太复杂statement_too_complex
54011字段太多too_many_columns
54023参数太多too_many_arguments
Class 55 — 对象不在预先要求的状态
55000对象不在预先要求的状态object_not_in_prerequisite_state
55006对象在使用中object_in_use
55P02无法修改运行时参数cant_change_runtime_param
55P03锁不可获取lock_not_available
Class 57 — 操作者干涉
57000操作者干涉operator_intervention
57014查询被取消query_canceled
57P01管理员关机admin_shutdown
57P02崩溃关机crash_shutdown
57P03现在无法连接cannot_connect_now
57P04删除数据库database_dropped
Class 58 — 系统错误(PostgreSQL 自己内部的错误)
58030IO错误io_error
58P01未定义的文件undefined_file
58P02备份文件(未定义文件)duplicate_file
Class F0 — 配置文件错误
F0000配置文件错误config_file_error
F0001锁文件存在lock_file_exists
Class P0 — PL/pgSQL 错误
P0000PL/pgSQL 错误plpgsql_error
P0001上升异常raise_exception
P0002未找到数据no_data_found
P0003行太多too_many_rows
Class XX — 内部错误
XX000内部错误internal_error
XX001数据损坏data_corrupted
XX002索引损坏index_corrupted