附录 A.PostgreSQL错误代码

PostgreSQL服务器发出的所有消息均被分配了五字符错误代码，这些代码遵循 SQL 标准对“SQLSTATE”代码的约定。需要了解已发生哪种错误条件的应用程序通常应测试错误代码，而不是查看文本错误消息。在PostgreSQL版本之间，错误代码不太可能发生变化，并且也不会因错误消息的本地化而发生变化。请注意，PostgreSQL生成的错误代码中有些（但并非全部）由 SQL 标准定义；针对标准未定义的条件，已发明或借用了其他数据库的一些其他错误代码。

根据该标准，错误代码的前两个字符表示错误类别，而后三个字符表示该类别中的特定条件。因此，不识别特定错误代码的应用程序可能仍能从错误类别推断出该做什么。

表 A.1列出了PostgreSQL16.2 中定义的所有错误代码。（有些目前实际上未使用，但由 SQL 标准定义。）错误类别也已显示。对于每个错误类别，都有一个“标准”错误代码，其后三个字符为000。此代码仅用于属于该类别但未分配任何更具体代码的错误条件。

“条件名称”列中显示的符号是在PL/pgSQL中使用的条件名称。条件名称可以大写或小写书写。（请注意，PL/pgSQL不识别警告（与错误相反）条件名称；这些是类别 00、01 和 02。）

对于某些类型的错误，服务器会报告与错误关联的数据库对象（表、表列、数据类型或约束）的名称；例如，导致unique_violation错误的唯一约束的名称。此类名称在错误报告消息的单独字段中提供，以便应用程序不必尝试从消息可能本地化的可读文本中提取它们。截至PostgreSQL9.3，此功能的完整覆盖范围仅存在于 SQLSTATE 类 23（完整性约束冲突）中的错误，但将来可能会扩展此范围。

表 A.1.PostgreSQL错误代码

错误代码	条件名称
类 00 — 成功完成
`00000`	`successful_completion`
类 01 — 警告
`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`
类 02 — 无数据（根据 SQL 标准，这也是一个警告类）
`02000`	`no_data`
`02001`	`no_additional_dynamic_result_sets_returned`
类 03 — SQL 语句尚未完成
`03000`	`sql_statement_not_yet_complete`
类 08 — 连接异常
`08000`	`connection_exception`
`08003`	`connection_does_not_exist`
`08006`	`connection_failure`
`08001`	`sqlclient_unable_to_establish_sqlconnection`
`08004`	`sqlserver_rejected_establishment_of_sqlconnection`
`08007`	`transaction_resolution_unknown`
`08P01`	`protocol_violation`
类 09 — 触发操作异常
`09000`	`triggered_action_exception`
类 0A — 不支持的功能
`0A000`	`feature_not_supported`
类 0B — 无效的事务启动
`0B000`	`invalid_transaction_initiation`
类 0F — 定位器异常
`0F000`	`locator_exception`
`0F001`	`invalid_locator_specification`
类 0L — 无效的授予者
`0L000`	`invalid_grantor`
`0LP01`	`invalid_grant_operation`
类 0P — 无效的角色规范
`0P000`	`invalid_role_specification`
类 0Z — 诊断异常
`0Z000`	`diagnostics_exception`
`0Z002`	`stacked_diagnostics_accessed_without_active_handler`
类 20 — 未找到案例
`20000`	`case_not_found`
类 21 — 基数违规
`21000`	`cardinality_violation`
类 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`
`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`	`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`
`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`	`numeric_value_out_of_range`
`2200H`	`sequence_generator_limit_exceeded`
`22026`	`string_data_length_mismatch`
`22001`	`string_data_right_truncation`
`22011`	`substring_error`
`22027`	`trim_error`
`22024`	`unterminated_c_string`
`2200F`	`zero_length_character_string`
`22P01`	`floating_point_exception`
`22P02`	`invalid_text_representation`
`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`
第 23 类 — 完整性约束违规
`23000`	`integrity_constraint_violation`
`23001`	`restrict_violation`
`23502`	`not_null_violation`
`23503`	`foreign_key_violation`
`23505`	`unique_violation`
`23514`	`check_violation`
`23P01`	`exclusion_violation`
第 24 类 — 无效光标状态
`24000`	`invalid_cursor_state`
第 25 类 — 无效事务状态
`25000`	`invalid_transaction_state`
`25001`	`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`	`no_active_sql_transaction_for_branch_transaction`
`25006`	`read_only_sql_transaction`
`25007`	`schema_and_data_statement_mixing_not_supported`
`25P01`	`no_active_sql_transaction`
`25P02`	`in_failed_sql_transaction`
`25P03`	`idle_in_transaction_session_timeout`
第 26 类 — 无效 SQL 语句名称
`26000`	`invalid_sql_statement_name`
第 27 类 — 触发的数据更改违规
`27000`	`触发_数据_更改_违规`
第 28 类 — 无效授权规范
`28000`	`invalid_authorization_specification`
`28P01`	`invalid_password`
第 2B 类 — 仍存在依赖权限描述符
`2B000`	`dependent_privilege_descriptors_still_exist`
`2BP01`	`dependent_objects_still_exist`
第 2D 类 — 无效事务终止
`2D000`	`invalid_transaction_termination`
第 2F 类 — SQL 例程异常
`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`
第 34 类 — 无效游标名称
`34000`	`invalid_cursor_name`
第 38 类 — 外部例程异常
`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`
第 39 类 — 外部例程调用异常
`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`
第 3B 类 — 保存点异常
`3B000`	`savepoint_exception`
`3B001`	`invalid_savepoint_specification`
第 3D 类 — 无效目录名称
`3D000`	`invalid_catalog_name`
第 3F 类 — 无效架构名称
`3F000`	`invalid_schema_name`
第 40 类 — 事务回滚
`40000`	`transaction_rollback`
`40002`	`transaction_integrity_constraint_violation`
`40001`	`serialization_failure`
`40003`	`statement_completion_unknown`
`40P01`	`deadlock_detected`
第 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`
`42P21`	`collation_mismatch`
`42P22`	`indeterminate_collation`
`42809`	`wrong_object_type`
`428C9`	`generated_always`
`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`	`重复表`
`42712`	`重复别名`
`42710`	`重复对象`
`42702`	`歧义列`
`42725`	`歧义函数`
`42P08`	`歧义参数`
`42P09`	`歧义别名`
`42P10`	`无效列引用`
`42611`	`无效列定义`
`42P11`	`无效游标定义`
`42P12`	`无效数据库定义`
`42P13`	`无效函数定义`
`42P14`	`无效预处理语句定义`
`42P15`	`无效模式定义`
`42P16`	`无效表定义`
`42P17`	`无效对象定义`
第 44 类 — WITH CHECK OPTION 违规
`44000`	`with_check_option_violation`
第 53 类 — 资源不足
`53000`	`insufficient_resources`
`53100`	`disk_full`
`53200`	`out_of_memory`
`53300`	`too_many_connections`
`53400`	`configuration_limit_exceeded`
第 54 类 — 程序限制超出
`54000`	`program_limit_exceeded`
`54001`	`statement_too_complex`
`54011`	`too_many_columns`
`54023`	`too_many_arguments`
第 55 类 — 对象不在先决条件状态
`55000`	`object_not_in_prerequisite_state`
`55006`	`object_in_use`
`55P02`	`cant_change_runtime_param`
`55P03`	`lock_not_available`
`55P04`	`unsafe_new_enum_value_usage`
第 57 类 — 操作员干预
`57000`	`operator_intervention`
`57014`	`query_canceled`
`57P01`	`admin_shutdown`
`57P02`	`crash_shutdown`
`57P03`	`cannot_connect_now`
`57P04`	`database_dropped`
`57P05`	`idle_session_timeout`
第 58 类 — 系统错误（PostgreSQL 本身外部的错误）
`58000`	`system_error`
`58030`	`io_error`
`58P01`	`undefined_file`
`58P02`	`duplicate_file`
第 72 类 — 快照失败
`72000`	`snapshot_too_old`
第 F0 类 — 配置文件错误
`F0000`	`config_file_error`
`F0001`	`lock_file_exists`
第 HV 类 — 外部数据包装器错误 (SQL/MED)
`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`
第 0 类 — PL/pgSQL 错误
`P0000`	`plpgsql_error`
`P0001`	`raise_exception`
`P0002`	`no_data_found`
`P0003`	`too_many_rows`
`P0004`	`assert_failure`
第 XX 类 — 内部错误
`XX000`	`internal_error`
`XX001`	`data_corrupted`
`XX002`	`index_corrupted`

附录 A.PostgreSQL错误代码 ​

附录 A.PostgreSQL错误代码