附录 A. PostgreSQL 错误代码

PostgreSQL 服务器发出的所有消息都分配有五个字符的错误代码，这些错误代码遵循 SQL 标准对“ SQLSTATE”代码的约定。需要知道发生哪种错误情况的应用程序通常应测试错误代码，而不是查看文本错误消息。错误代码在 PostgreSQL 发行版中不太可能更改，并且也不会由于错误消息的本地化而更改。注意，PostgreSQL 产生的一些但不是全部错误代码是由 SQL 标准定义的。从其他数据库中发明或借用了一些针对该标准未定义的条件的其他错误代码。

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

Table A.1列出了 PostgreSQL 10.13 中定义的所有错误代码。 (目前尚不实际使用，但已由 SQL 标准定义.)还显示了错误类。对于每个错误类别，都有一个“标准”错误代码，该代码具有最后三个字符000。该代码仅用于属于该类但没有分配任何更特定代码的错误条件。

“条件名称”列中显示的符号是要在 PL/pgSQL 中使用的条件名称。条件名称可以大写或小写。 (请注意，PL/pgSQL 无法识别警告，而不是错误的条件名称；它们是类 00、01 和 02.)

对于某些类型的错误，服务器报告与该错误关联的数据库对象的名称(表，表列，数据类型或约束)。例如，导致unique_violation错误的唯一约束的名称。这些名称在错误报告消息的单独字段中提供，因此应用程序无需尝试从消息的可能本地化的人类可读文本中提取它们。从 PostgreSQL 9.3 开始，仅针对 SQLSTATE class 23(完整性约束违规)中的错误才存在此功能的完整覆盖范围，但是将来可能会扩大。

表 A.1.PostgreSQL 错误代码

Error Code	Condition Name
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`
Class 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 类-无效的 Transaction 发起
`0B000`	`invalid_transaction_initiation`
0F 级-定位器 exception
`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`
`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`
第 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 类-无效的 Transaction 状态
`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`	`triggered_data_change_violation`
第 28 类-无效的授权规范
`28000`	`invalid_authorization_specification`
`28P01`	`invalid_password`
第 2B 类-依存特权 Descriptors 仍然存在
`2B000`	`dependent_privilege_descriptors_still_exist`
`2BP01`	`dependent_objects_still_exist`
2D 类-无效的 Transaction 终止
`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 类-外部例行 exception
`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 类-保存点 exception
`3B000`	`savepoint_exception`
`3B001`	`invalid_savepoint_specification`
3D 类-无效的目录名称
`3D000`	`invalid_catalog_name`
3F 类-无效的架构名称
`3F000`	`invalid_schema_name`
第 40 类-Transaction 回滚
`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`	`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`
44 级-违反检查选项
`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`
第 57 类-操作员干预
`57000`	`operator_intervention`
`57014`	`query_canceled`
`57P01`	`admin_shutdown`
`57P02`	`crash_shutdown`
`57P03`	`cannot_connect_now`
`57P04`	`database_dropped`
第 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`
P0 类-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`

Docs

Docs4dev

Title here

附录 A. PostgreSQL 错误代码