| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Fast Forward | Next | |
PostgreSQL서버에 의해 발행되는 모든 메세지는 "SQLSTATE" 코드의 SQL 표준 관례에 따른 다섯 문자 에러 코드로 지정됩니다. 어떠한 에러 상태가 발생되었는지 파악해야 하는 어플리케이션은, 보통 텍스트의 에러 메세지를 확인하는 것이 아닌, 에러 코드를 검사해야만 합니다. 에러 코드는 PostgreSQL 릴리스에 따른 변화는 거의 없습니다. 또한, 에러 메세지의 각국 언어화에 의한 변경에도 영향을 받지 않습니다. PostgreSQL에서 발생하는 전부가 아닌 일부 에러 코드를 SQL 표준으로 정의하고 있는 것을 알아주십시요. 표준 SQL로 정의되지 않은 추가적인 에러 코드는 다른 데이터베이스로부터 넘어오거나 만들어진 것입니다.
표준 SQL에 따르면, 에러 코드의 처음 2 문자는 클래스의 에러를 나타내는 반면, 나머지 3 문자는 그 클래스의 특정 조건을 나타냅니다. 이와 같이 특정한 에러 코드를 알아채지 못하는 어플리케이션도 에러 클래스로부터 무엇을 해야 하는가를 추정하는이 가능합니다.
Table A-1은 PostgreSQL 8.3.3로 정의된 에러 코드를 모두 가지고 있습니다. (표준 SQL에서는 정의되고 있지만 현재 사용되지 않는 것도 있습니다). 에러 클래스 또한 보여집니다. 각 에러 클래스에 대해 나머지 3 문자가 000인 "표준"에러 코드가 있습니다. 이 코드는 클래스 내에서 발생되었지만 특정한 코드를 할당받지 않은 에러 상태에서만 사용됩니다.
각 에러 코드에 대한 PL/pgSQL상태는 공백 대신에 밑줄이 그어지며, 테이블에 나타나는 표현과 동일합니다. 예를 들면, 코드22012, DIVISION BY ZERO,는 상태명은 DIVISION_BY_ZERO입니다. 상태명은 대문자와 소문자로 쓰여질 수 있습니다. (PL/pgSQL는, 에러의 경우와 달리, 경고의 경우에는 상태명을 인식하지 않습니다. 이들은 클래스 00, 01과 02입니다).
Table A-1. PostgreSQL에러 코드
| 에러 코드 | 의미 | 상수 |
|---|---|---|
| 00 클래스 — 정상 종료 | ||
| 00000 | 정상 종료 | successful_completion |
| 01 클래스 — 경고 | ||
| 01000 | 경고 | warning |
| 0100C | 동적인 결과 세트 반환 | dynamic_result_sets_returned |
| 01008 | 암묵적인 0 비트 입력 | implicit_zero_bit_padding |
| 01003 | 집합 함수 내 NULL 값 생략 | null_value_eliminated_in_set_function |
| 01007 | 권한이 부여되지 않음 | privilege_not_granted |
| 01006 | 권한이 취소되지 않았음 | privilege_not_revoked |
| 01004 | STRING 데이터 우측이 끊김 | string_data_right_truncation |
| 01P01 | 반대 기능 | deprecated_feature |
| 02 클래스 — 데이터 없음 (SQL 표준에 의한 경고 클래스임) | ||
| 02000 | 데이터 없음 | no_data |
| 02001 | 추가적인 동적 결과 세트가 반환되지 않음 | no_additional_dynamic_result_sets_returned |
| 03 클래스 — SQL문의 미완료 | ||
| 03000 | SQL문이 완료되지 않음 | sql_statement_not_yet_complete |
| 08 클래스 — 접속 예외 | ||
| 08000 | 접속 예외 발생 | connection_exception |
| 08003 | 접속이 존재하지 않음 | connection_does_not_exist |
| 08006 | 접속 실패 | connection_failure |
| 08001 | SQL 클라이언트는 SQL 접속할 수 없음 | sqlclient_unable_to_establish_sqlconnection |
| 08004 | SQL 서버가 SQL 접속 성립 거절 | sqlserver_rejected_establishment_of_sqlconnection |
| 08007 | 트랜잭션(transaction) 해결이 불분명함 | transaction_resolution_unknown |
| 08P01 | 프로토콜 위반 | protocol_violation |
| 09 클래스 — 트리거에 의한 액션 예외 | ||
| 09000 | 트리거에 의한 액션 예외 | triggered_action_exception |
| 0A 클래스 — 지원되지 않는 기능 | ||
| 0A000 | 지원되지 않는 기능 | feature_not_supported |
| 0B 클래스 — 잘못된 트랜잭션(transaction) 시작 | ||
| 0B000 | 잘못된 트랜잭션(transaction) 시작 | invalid_transaction_initiation |
| 0F 클래스 — locator 예외 | ||
| 0F000 | locator의 예외 | locator_exception |
| 0F001 | 잘못된 locator 지정 | invalid_locator_specification |
| 0L 클래스 — 잘못된 권한 부여 | ||
| 0L000 | 잘못된 권한 부여 | invalid_grantor |
| 0LP01 | 잘못된 권한 부여 수행 | invalid_grant_operation |
| 0P 클래스 — 잘못된 롤(role)의 지정 | ||
| 0P000 | 잘못된 롤(role)의 지정 | invalid_role_specification |
| 21 클래스 — 카디널리티(Cardinality) 위반 | ||
| 21000 | 카디널리티(Cardinality) 위반 | cardinality_violation |
| 22 클래스 — 데이터 예외 | ||
| 22000 | 데이터 예외 | data_exception |
| 2202E | 배열 첨자 에러 | array_subscript_error |
| 22021 | 허용 범위 외의 문자 | character_not_in_repertoire |
| 22008 | 날짜 시각 필드의 오버플로우 | datetime_field_overflow |
| 22012 | 0으로 제산 | division_by_zero |
| 22005 | 대입 에러 | error_in_assignment |
| 2200B | 이스케이프 문자의 충돌 | escape_character_conflict |
| 22022 | 지시자 오버플로우 | indicator_overflow |
| 22015 | 내부 필드의 오버플로우 | interval_field_overflow |
| 2201E | 잘못된 인수의 대수 | invalid_argument_for_logarithm |
| 2201F | 잘못된 멱급함수(POWER FUNCTION)의 인수 | invalid_argument_for_power_function |
| 2201G | 잘못된 폭 버킷 함수의 인수 | invalid_argument_for_width_bucket_function |
| 22018 | 잘못된 캐스트 문자 | invalid_character_value_for_cast |
| 22007 | 잘못된 날짜 시각 형식 | invalid_datetime_format |
| 22019 | 잘못된 이스케이프 문자(ESCAPE CHARACTER) | invalid_escape_character |
| 2200D | 잘못된 이스케이프 옥테트(8 비트) | invalid_escape_octet |
| 22025 | 잘못된 이스케이프 순서 | invalid_escape_sequence |
| 22P06 | 이스케이프 문자의 비표준 사용 | nonstandard_use_of_escape_character |
| 22010 | 잘못된 지시자 파라미터의 값 | invalid_indicator_parameter_value |
| 22020 | 잘못된 한도값 | invalid_limit_value |
| 22023 | 잘못된 파라미터 값 | invalid_parameter_value |
| 2201B | 잘못된 정규 표현 | invalid_regular_expression |
| 22009 | 잘못된 타임존 치환 값 | invalid_time_zone_displacement_value |
| 2200C | 잘못된 이스케이프 문자 사용 | invalid_use_of_escape_character |
| 2200G | 가장 명확한 형태의 불일치 | most_specific_type_mismatch |
| 22004 | NULL 값이 허락되지 않음 | null_value_not_allowed |
| 22002 | NULL 값, 지시자 파라미터 없음 | null_value_no_indicator_parameter |
| 22003 | 범위 외의 수치 | numeric_value_out_of_range |
| 22026 | STRING 데이터 길이의 불일치 | string_data_length_mismatch |
| 22001 | STRING 데이터의 우측 끊김 | string_data_right_truncation |
| 22011 | 부분 STRING 에러 | substring_error |
| 22027 | TRIM 에러 | trim_error |
| 22024 | 무한의 C 문자열 | unterminated_c_string |
| 2200F | 길이가 0인 캐릭터 문자열 | zero_length_character_string |
| 22P01 | 부동 소수점 예외 | floating_point_exception |
| 22P02 | 잘못된 텍스트 표현 | invalid_text_representation |
| 22P03 | 잘못된 바이너리 표현 | invalid_binary_representation |
| 22P04 | 사본 파일의 서식 불량 | bad_copy_file_format |
| 22P05 | 번역할 수 없는 문자 | untranslatable_character |
| Class 23 — Integrity Constraint Violation | ||
| 23000 | 무결성 제약 위반 | integrity_constraint_violation |
| 23001 | 제한 위반 | restrict_violation |
| 23502 | 비NULL 위반 | not_null_violation |
| 23503 | 외부키 위반 | foreign_key_violation |
| 23505 | 유일성 위반 | unique_violation |
| 23514 | 검사 위반 | check_violation |
| 24 클래스 — 잘못된 커서 상태 | ||
| 24000 | 잘못된 커서 상태 | invalid_cursor_state |
| 25 클래스 — 잘못된 트랜잭션(transaction) 상태 | ||
| 25000 | 잘못된 트랜잭션(transaction) 상태 | invalid_transaction_state |
| 25001 | SQL 트랜잭션(transaction) 실행 중 | active_sql_transaction |
| 25002 | 분기 트랜잭션(transaction)이 이미 실행 중 | branch_transaction_already_active |
| 25008 | 유지된 커서는 동일한 차단 레벨 요구 | held_cursor_requires_same_isolation_level |
| 25003 | 분기 트랜잭션(transaction)의 부적절한 액세스 모드 | inappropriate_access_mode_for_branch_transaction |
| 25004 | 분기 트랜잭션(transaction)에 있어서의 부적절한 차단 레벨 | inappropriate_isolation_level_for_branch_transaction |
| 25005 | 분기 트랜잭션(transaction)에 대한 작동 중인 SQL 트랜잭션(transaction)이 존재하지 않음 | no_active_sql_transaction_for_branch_transaction |
| 25006 | 읽기 전용의 SQL 트랜잭션(transaction) | read_only_sql_transaction |
| 25007 | schema와 데이터문의 혼재는 지원되지 않음 | schema_and_data_statement_mixing_not_supported |
| 25P01 | 작동 중인 SQL 트랜잭션(transaction)이 없음 | no_active_sql_transaction |
| 25P02 | 실패한 SQL 트랜잭션(transaction) 내임 | in_failed_sql_transaction |
| 26 클래스 — 잘못된 SQL문의 이름 | ||
| 26000 | 잘못된 SQL문의 이름 | invalid_sql_statement_name |
| 27 클래스 — 트리거 데이터 변경 위반 | ||
| 27000 | 트리거 데이터 변경 위반 | triggered_data_change_violation |
| 28 클래스 — 잘못된 인증 지정 | ||
| 28000 | 잘못된 인증 지정 | invalid_authorization_specification |
| 2B 클래스 — 의존하는 권한 기술어가 아직 존재함 | ||
| 2B000 | 의존하는 권한 기술어가 아직 존재함 | dependent_privilege_descriptors_still_exist |
| 2BP01 | 의존하는 항목이 아직 존재함 | dependent_objects_still_exist |
| 2D 클래스 — 잘못된 트랜잭션(transaction)의 종료 | ||
| 2D000 | 잘못된 트랜잭션(transaction)의 종료 | invalid_transaction_termination |
| 2F 클래스 — SQL 함수 예외 | ||
| 2F000 | SQL 함수 예외 | sql_routine_exception |
| 2F005 | 실행 함수에 RETURN 문이 없음 | 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 |
| 34 클래스 — 잘못된 커서 명칭 | ||
| 34000 | 잘못된 커서 명칭 | invalid_cursor_name |
| 38 클래스 — 외부 함수 예외 | ||
| 38000 | 외부 함수 예외 | external_routine_exception |
| 38001 | 포함된 SQL은 허가되지 않음 | containing_sql_not_permitted |
| 38002 | SQL 데이터 변경은 허가되지 않음 | modifying_sql_data_not_permitted |
| 38003 | 금지된 SQL문 시도 | prohibited_sql_statement_attempted |
| 38004 | SQL 데이터 읽기는 허가되지 않음 | reading_sql_data_not_permitted |
| 39 클래스 — 외부 함수 호출 예외 | ||
| 39000 | 외부 함수 호출 예외 | external_routine_invocation_exception |
| 39001 | 잘못된 SQL 상태가 반환됨 | invalid_sqlstate_returned |
| 39004 | NULL 값이 허락되지 않음 | null_value_not_allowed |
| 39P01 | 트리거 프로토콜 위반 | trigger_protocol_violated |
| 39P02 | SRF 프로토콜 위반 | srf_protocol_violated |
| 3B 클래스 — 세이브 포인트 예외 | ||
| 3B000 | 세이브 포인트 예외 | savepoint_exception |
| 3B001 | 잘못된 세이브 포인트 지정 | invalid_savepoint_specification |
| 3D 클래스 — 잘못된 카탈로그 명칭 | ||
| 3D000 | 잘못된 카탈로그 명칭 | invalid_catalog_name |
| 3F 클래스 — 잘못된 schema 명칭 | ||
| 3F000 | 잘못된 schema 명칭 | invalid_schema_name |
| 40 클래스 — 트랜잭션(transaction) 롤백(rollback) | ||
| 40000 | 트랜잭션(transaction) 롤백(rollback) | transaction_rollback |
| 40002 | 트랜잭션(transaction) 무결성 제약 위반 | transaction_integrity_constraint_violation |
| 40001 | 직렬화 실패 | serialization_failure |
| 40003 | 문장 완료 불분명 | statement_completion_unknown |
| 40P01 | 데드락(deadlock) 발견 | deadlock_detected |
| 42 클래스 — 구문 에러, 혹은 액세스 롤(role) 위반 | ||
| 42000 | 구문 에러, 혹은 액세스 롤(role) 위반 | syntax_error_or_access_rule_violation |
| 42601 | 구문 에러 | syntax_error |
| 42501 | 불충분한 권한 | insufficient_privilege |
| 42846 | 강제형 변환 불가능 | cannot_coerce |
| 42803 | 그룹화 에러 | grouping_error |
| 42830 | 잘못된 외부 키 | invalid_foreign_key |
| 42602 | 잘못된 명칭 | invalid_name |
| 42622 | 너무 긴 명칭 | name_too_long |
| 42939 | 예약어(reserved word) | reserved_name |
| 42804 | 데이터 타입의 불일치 | datatype_mismatch |
| 42P18 | 데이터 타입의 부정확 | indeterminate_datatype |
| 42809 | 부적당한 오브젝트의 형태 | wrong_object_type |
| 42703 | 정의되지 않은 열(column) | undefined_column |
| 42883 | 정의되지 않은 함수 | undefined_function |
| 42P01 | 정의되지 않은 테이블 | undefined_table |
| 42P02 | 정의되지 않은 파라미터 | undefined_parameter |
| 42704 | 정의되지 않은 오브젝트 | undefined_object |
| 42701 | 중복된 열(column) | duplicate_column |
| 42P03 | 커서의 중복 | duplicate_cursor |
| 42P04 | 데이터베이스의 중복 | duplicate_database |
| 42723 | 함수의 중복 | duplicate_function |
| 42P05 | 준비된 문장(prepared statement)의 중복 | duplicate_prepared_statement |
| 42P06 | schema의 중복 | duplicate_schema |
| 42P07 | 테이블의 중복 | duplicate_table |
| 42712 | 별칭(alias)의 중복 | duplicate_alias |
| 42710 | 오브젝트의 중복 | duplicate_object |
| 42702 | 모호한 열(column) | ambiguous_column |
| 42725 | 모호한 함수 | ambiguous_function |
| 42P08 | 모호한 파라미터 | ambiguous_parameter |
| 42P09 | 모호한 별칭(alias) | ambiguous_alias |
| 42P10 | 잘못된 열(colunm) 참조 | invalid_column_reference |
| 42611 | 잘못된 열(column) 정의 | invalid_column_definition |
| 42P11 | 잘못된 커서 정의 | invalid_cursor_definition |
| 42P12 | 잘못된 데이터베이스 정의 | invalid_database_definition |
| 42P13 | 잘못된 함수 정의 | invalid_function_definition |
| 42P14 | 잘못된 준비된 문장(prepared statement)의 정의 | invalid_prepared_statement_definition |
| 42P15 | 잘못된 schema 정의 | 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 |
| 54 클래스 — 프로그램 제한 초과 | ||
| 54000 | 프로그램 제한의 초과 | program_limit_exceeded |
| 54001 | 문장이 너무 복잡함 | statement_too_complex |
| 54011 | 열(column)이 너무 많음 | too_many_columns |
| 54023 | 인자(argument)가 너무 많음 | too_many_arguments |
| 클래스 55 — 필요조건을 만족하지 않는 오브젝트 | ||
| 55000 | 필요조건을 만족하지 않는 오브젝트 | object_not_in_prerequisite_state |
| 55006 | 사용 중인 오브젝트 | object_in_use |
| 55P02 | 함수 파라미터는 변경할 수 없음 | cant_change_runtime_param |
| 55P03 | 락(lock)을 사용할 수 없음 | lock_not_available |
| 57 클래스 — operator 개입 | ||
| 57000 | operator 개입 | operator_intervention |
| 57014 | 쿼리가 취소됨 | query_canceled |
| 57P01 | 관리자에 의한 정지 | admin_shutdown |
| 57P02 | 고장에 의한 정지 | crash_shutdown |
| 57P03 | 현재 접속할 수 없음 | cannot_connect_now |
| 58 클래스 — 시스템 오류(외부 원인에 의한PostgreSQL자체의 에러) | ||
| 58030 | 입출력 에러 | io_error |
| 58P01 | 정의되지 않은 파일 | undefined_file |
| 58P02 | 중복된 파일 | duplicate_file |
| F0 클래스 — 설정 파일 에러 | ||
| F0000 | 설정 파일 에러 | config_file_error |
| F0001 | 잠금 파일 존재함 | lock_file_exists |
| P0 클래스 — PL/pgSQL 에러 | ||
| P0000 | PLPGSQL 에러 | plpgsql_error |
| P0001 | 예외 발생 | raise_exception |
| P0002 | 데이터가 없음 | no_data_found |
| P0003 | 행이 너무 많음 | too_many_rows |
| XX 클래스 — 내부 에러 | ||
| XX000 | 내부 에러 | internal_error |
| XX001 | 데이터의 파손 | data_corrupted |
| XX002 | 인덱스의 파손 | index_corrupted |