PostgreSQL 伺服器發出的所有訊息都被分配了五字元的錯誤程式碼,這些程式碼遵循 SQL 標準關於“SQLSTATE”程式碼的約定。需要了解發生何種錯誤情況的應用程式通常應測試錯誤程式碼,而不是檢視文字錯誤訊息。錯誤程式碼在 PostgreSQL 版本之間不太可能發生更改,並且也不會因錯誤訊息的本地化而更改。請注意,PostgreSQL 生成的錯誤程式碼中只有一部分(並非全部)由 SQL 標準定義;對於標準未定義的條件,已發明或借用了其他資料庫的一些附加錯誤程式碼。
根據標準,錯誤程式碼的前兩個字元表示錯誤類別,後三個字元表示該類別中的特定條件。因此,不識別特定錯誤程式碼的應用程式可能仍然可以根據錯誤類別推斷出要執行的操作。
表 A.1 列出了 PostgreSQL 18.0 中定義的所有錯誤程式碼。(其中一些目前實際上並未被使用,但由 SQL 標準定義。)還顯示了錯誤類別。對於每個錯誤類別,都有一個“標準”錯誤程式碼,其後三個字元為 000
。此程式碼僅用於屬於該類別但沒有分配更具體程式碼的錯誤條件。
“條件名稱”列中顯示的符號是在 PL/pgSQL 中使用的條件名稱。條件名稱可以是大寫或小寫。(請注意,PL/pgSQL 不識別警告條件名稱,與錯誤條件名稱相對;那些是類別 00、01 和 02。)
對於某些型別的錯誤,伺服器會報告與錯誤相關的資料庫物件(表、表列、資料型別或約束)的名稱;例如,導致 unique_violation
錯誤的唯一約束的名稱。此類名稱在錯誤報告訊息的單獨欄位中提供,因此應用程式無需嘗試從可能本地化的可讀文字訊息中提取它們。截至 PostgreSQL 9.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 |
類別 10 — XQuery 錯誤 | |
10608 |
invalid_argument_for_xquery |
類別 20 — 未找到 CASE | |
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 |
25P04 |
transaction_timeout |
類別 26 — 無效的 SQL 語句名稱 | |
26000 |
invalid_sql_statement_name |
類別 27 — 觸發的資料更改違反 | |
27000 |
triggered_data_change_violation |
類別 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 |
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 — 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 |
58P03 |
file_name_too_long |
類別 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 |
如果您在文件中看到任何不正確、與您在使用特定功能時的經驗不符或需要進一步澄清的內容,請使用 此表單 報告文件問題。