Коды ошибок PostgreSQL
Каждый код SQLSTATE, который может выдать PostgreSQL, сгруппирован по классам, как в официальном приложении. Для самых ходовых есть отдельные страницы: что означает ошибка, почему она возникает и как её исправить.
Чтение ошибки PostgreSQL
PostgreSQL идентифицирует каждую ошибку с помощью пятисимвольного кода SQLSTATE. Первые два символа обозначают класс: 23 является нарушением ограничения целостности, 42 является синтаксической ошибкой или нарушением правил доступа, 40 — откат транзакции, и так далее. Коды, оканчивающиеся на 000 — это общий код для своего класса.
psql показывает сообщение, а не код. Выполните \set VERBOSITY verbose чтобы увидеть SQLSTATE или прочитайте его из вашего драйвера: SQLSTATE в JDBC и ODBC, e.pgcode в psycopg2, e.sqlstate в psycopg 3, err.code в node-postgres.
В PL/pgSQL вы можете перехватить ошибку по имени условия (EXCEPTION WHEN unique_violation THEN) или по коду (WHEN SQLSTATE '23505' THEN).
Все ошибки PostgreSQL в этой справке
262 кода, 63 с полным разбором (со ссылкой). Коды и сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL.
Успешное завершение
| Код | Значение |
|---|---|
00000
|
successful_completion
|
Предупреждение
| Код | Значение |
|---|---|
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
|
Нет данных (это также класс предупреждений согласно стандарту SQL)
| Код | Значение |
|---|---|
02000
|
no_data
|
02001
|
no_additional_dynamic_result_sets_returned
|
SQL-запрос еще не завершен
| Код | Значение |
|---|---|
03000
|
sql_statement_not_yet_complete
|
Сбой подключения
| Код | Значение |
|---|---|
08000
|
connection_exception
|
08003
|
connection_does_not_exist
|
08006
|
сбой подключения
connection_failure
сервер неожиданно закрыл соединение. Это, вероятно, означает, что сервер завершил работу ненормально до или во время обработки запроса.
|
08001
|
невозможно установить соединение
sqlclient_unable_to_establish_sqlconnection
подключение к серверу "db.example.com" (10.0.0.5), порт 5432, не удалось: соединение отклонено. Запущен ли сервер на этом хосте и принимает ли он TCP/IP-подключения?
|
08004
|
sqlserver_rejected_establishment_of_sqlconnection
|
08007
|
transaction_resolution_unknown
|
08P01
|
protocol_violation
|
Исключение срабатывания действия
| Код | Значение |
|---|---|
09000
|
triggered_action_exception
|
Возможность не поддерживается
| Код | Значение |
|---|---|
0A000
|
функция не поддерживается
feature_not_supported
межбазовые ссылки не реализованы: "otherdb.public.orders"
|
Недопустимое начало транзакции
| Код | Значение |
|---|---|
0B000
|
invalid_transaction_initiation
|
Исключение локатора
| Код | Значение |
|---|---|
0F000
|
locator_exception
|
0F001
|
invalid_locator_specification
|
Недопустимый грантор
| Код | Значение |
|---|---|
0L000
|
invalid_grantor
|
0LP01
|
недопустимая операция предоставления прав
invalid_grant_operation
опции предоставления прав можно выдавать только ролям
|
Недопустимая спецификация роли
| Код | Значение |
|---|---|
0P000
|
invalid_role_specification
|
Исключение диагностики
| Код | Значение |
|---|---|
0Z000
|
diagnostics_exception
|
0Z002
|
stacked_diagnostics_accessed_without_active_handler
|
Ошибка XQuery
| Код | Значение |
|---|---|
10608
|
invalid_argument_for_xquery
|
CASE не найден
| Код | Значение |
|---|---|
20000
|
case_not_found
|
Нарушение кардинальности
| Код | Значение |
|---|---|
21000
|
подзапрос вернул более одной строки
cardinality_violation
подзапрос, использованный как выражение, вернул более одной строки
|
Исключение данных
| Код | Значение |
|---|---|
22000
|
data_exception
|
2202E
|
array_subscript_error
|
22021
|
недопустимая последовательность байтов для кодировки
character_not_in_repertoire
недопустимая последовательность байтов для кодировки "UTF8": 0xff
|
22008
|
значение поля даты/времени вне допустимого диапазона
datetime_field_overflow
значение поля даты/времени вне допустимого диапазона: "2026-13-01"
|
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
неверный синтаксис ввода для типа timestamp: "31/12/2026 25:00"
|
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
неверное значение параметра "TimeZone": "Mars/Olympus"
|
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
значение слишком длинное для типа character varying(20)
|
22011
|
substring_error
|
22027
|
trim_error
|
22024
|
unterminated_c_string
|
2200F
|
zero_length_character_string
|
22P01
|
floating_point_exception
|
22P02
|
неверный синтаксис ввода для типа
invalid_text_representation
неверный синтаксис ввода для типа integer: "abc"
|
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
|
Нарушение ограничения целостности
| Код | Значение |
|---|---|
23000
|
integrity_constraint_violation
|
23001
|
restrict_violation
|
23502
|
значение null нарушает ограничение not-null
not_null_violation
значение null в столбце "email" отношения "users" нарушает ограничение not-null DETAIL: Ошибочная строка: (7, Ada, null).
|
23503
|
нарушение ограничения внешнего ключа
foreign_key_violation
вставка или обновление в таблице "orders" нарушает ограничение внешнего ключа "orders_customer_id_fkey" DETAIL: Ключ (customer_id)=(42) отсутствует в таблице "customers".
|
23505
|
повторяющийся ключ нарушает ограничение уникальности
unique_violation
повторяющееся значение ключа нарушает ограничение уникальности «users_email_key» ПОДРОБНОСТИ: Ключ (email)=([email protected]) уже существует.
|
23514
|
нарушение ограничения CHECK
check_violation
новая строка для отношения "orders" нарушает ограничение проверки "orders_qty_check" DETAIL: Неудачная строка содержит (12, -1).
|
23P01
|
нарушение ограничения исключения
exclusion_violation
конфликтующее значение ключа нарушает исключающее ограничение "bookings_room_during_excl" DETAIL: Ключ (room_id, during)=(4, ["2026-05-01 10:00:00","2026-05-01 11:00:00")) конфликтует с существующим ключом (room_id, during)=(4, ["2026-05-01 10:30:00","2026-05-01 12:00:00")).
|
Недопустимое состояние курсора
| Код | Значение |
|---|---|
24000
|
invalid_cursor_state
|
Недопустимое состояние транзакции
| Код | Значение |
|---|---|
25000
|
invalid_transaction_state
|
25001
|
невозможно выполнить внутри блока транзакции
active_sql_transaction
CREATE INDEX CONCURRENTLY нельзя выполнить внутри блока транзакции
|
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
|
SQL-транзакция только для чтения
read_only_sql_transaction
невозможно выполнить INSERT в транзакции только для чтения
|
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
|
Недопустимое имя оператора SQL
| Код | Значение |
|---|---|
26000
|
invalid_sql_statement_name
|
Нарушение изменения данных
| Код | Значение |
|---|---|
27000
|
triggered_data_change_violation
|
Недопустимая спецификация авторизации
| Код | Значение |
|---|---|
28000
|
недопустимая спецификация авторизации
invalid_authorization_specification
нет записи в pg_hba.conf для хоста "10.0.0.5", пользователя "app", базы данных "shop", без шифрования
|
28P01
|
не удалось пройти аутентификацию по паролю
invalid_password
не удалось пройти аутентификацию по паролю для пользователя «app»
|
Зависимые дескрипторы привилегий всё ещё существуют
| Код | Значение |
|---|---|
2B000
|
dependent_privilege_descriptors_still_exist
|
2BP01
|
зависимые объекты все еще существуют
dependent_objects_still_exist
невозможно удалить таблицу customers, потому что другие объекты зависят от нее DETAIL: ограничение orders_customer_id_fkey в таблице orders зависит от таблицы customers HINT: Используйте DROP ... CASCADE, чтобы удалить также зависимые объекты.
|
Недопустимое завершение транзакции
| Код | Значение |
|---|---|
2D000
|
недопустимое завершение транзакции
invalid_transaction_termination
недопустимое завершение транзакции
|
Исключение 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
|
Недопустимое имя курсора
| Код | Значение |
|---|---|
34000
|
invalid_cursor_name
|
Исключение внешней подпрограммы
| Код | Значение |
|---|---|
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
|
Исключение вызова внешней подпрограммы
| Код | Значение |
|---|---|
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
|
Исключение точки сохранения
| Код | Значение |
|---|---|
3B000
|
savepoint_exception
|
3B001
|
недопустимая спецификация точки сохранения
invalid_savepoint_specification
точка сохранения "before_update" не существует
|
Недопустимое имя каталога
| Код | Значение |
|---|---|
3D000
|
база данных не существует
invalid_catalog_name
база данных "shop" не существует
|
Недопустимое имя схемы
| Код | Значение |
|---|---|
3F000
|
схема не существует
invalid_schema_name
схема "sales" не существует
|
Откат транзакции
| Код | Значение |
|---|---|
40000
|
transaction_rollback
|
40002
|
transaction_integrity_constraint_violation
|
40001
|
невозможно сериализовать доступ
serialization_failure
невозможно сериализовать доступ из-за одновременного обновления
|
40003
|
statement_completion_unknown
|
40P01
|
обнаружена взаимная блокировка
deadlock_detected
обнаружена взаимная блокировка DETAIL: Процесс 1234 ожидает ShareLock для транзакции 5678; заблокирован процессом 4321. Процесс 4321 ожидает ShareLock для транзакции 8765; заблокирован процессом 1234.
|
Ошибка синтаксиса или нарушение правила доступа
| Код | Значение |
|---|---|
42000
|
syntax_error_or_access_rule_violation
|
42601
|
синтаксическая ошибка рядом с
syntax_error
синтаксическая ошибка рядом с "FROM" LINE 1: SELECT id, name, FROM users; ^
|
42501
|
доступ запрещен
insufficient_privilege
доступ к таблице orders запрещен
|
42846
|
невозможно привести тип
cannot_coerce
невозможно преобразовать тип integer в uuid
|
42803
|
столбец должен присутствовать в выражении GROUP BY
grouping_error
столбец "o.customer_id" должен присутствовать в выражении GROUP BY или использоваться в агрегатной функции
|
42P20
|
windowing_error
|
42P19
|
invalid_recursion
|
42830
|
недопустимый внешний ключ
invalid_foreign_key
не существует уникального ограничения, соответствующего указанным ключам для ссылочной таблицы "customers"
|
42602
|
invalid_name
|
42622
|
name_too_long
|
42939
|
reserved_name
|
42804
|
несоответствие типов данных
datatype_mismatch
столбец "created_at" имеет тип timestamp с часовым поясом, но выражение имеет тип integer ПОДСКАЗКА: вам нужно будет переписать или привести выражение.
|
42P18
|
не удалось определить тип данных параметра
indeterminate_datatype
не удалось определить тип данных параметра $1
|
42P21
|
collation_mismatch
|
42P22
|
indeterminate_collation
|
42809
|
wrong_object_type
|
428C9
|
generated_always
|
42703
|
столбец не существует
undefined_column
столбец "emial" не существует СТРОКА 1: SELECT emial FROM users; ^ ПОДСКАЗКА: возможно, вы имели в виду обратиться к столбцу "users.email".
|
42883
|
функция не существует
undefined_function
функция lower(integer) не существует
LINE 1: SELECT lower(42);
^
ПОДСКАЗКА: Функция с данным именем и типами аргументов не найдена. Возможно, потребуется явное приведение типов.
|
42P01
|
отношение не существует
undefined_table
отношение "orders" не существует LINE 1: SELECT * FROM orders; ^
|
42P02
|
параметр отсутствует
undefined_parameter
параметр $1 отсутствует
|
42704
|
неопределённый объект
undefined_object
тип "jsonbb" не существует
|
42701
|
duplicate_column
|
42P03
|
duplicate_cursor
|
42P04
|
база данных уже существует
duplicate_database
база данных "shop" уже существует
|
42723
|
duplicate_function
|
42P05
|
duplicate_prepared_statement
|
42P06
|
схема уже существует
duplicate_schema
схема "sales" уже существует
|
42P07
|
отношение уже существует
duplicate_table
отношение "orders" уже существует
|
42712
|
duplicate_alias
|
42710
|
дубликат объекта
duplicate_object
роль "app" уже существует
|
42702
|
ссылка на столбец неоднозначна
ambiguous_column
ссылка на столбец "id" неоднозначна LINE 1: SELECT id FROM orders JOIN customers ON customers.id = orders.customer_id; ^
|
42725
|
ambiguous_function
|
42P08
|
ambiguous_parameter
|
42P09
|
ambiguous_alias
|
42P10
|
недопустимая ссылка на столбец
invalid_column_reference
нет уникального или исключающего ограничения, соответствующего спецификации ON CONFLICT
|
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
|
Нарушение WITH CHECK OPTION
| Код | Значение |
|---|---|
44000
|
with_check_option_violation
|
Недостаточно ресурсов
| Код | Значение |
|---|---|
53000
|
insufficient_resources
|
53100
|
диск заполнен
disk_full
не удалось расширить файл "base/16384/16397": на устройстве не осталось места HINT: Проверьте свободное место на диске.
|
53200
|
недостаточно памяти
out_of_memory
недостаточно памяти DETAIL: Не удалось выполнить запрос размера 1048576 в контексте памяти "ExecutorState".
|
53300
|
слишком много подключений
too_many_connections
извините, клиентов уже слишком много
|
53400
|
configuration_limit_exceeded
|
Превышено ограничение программы
| Код | Значение |
|---|---|
54000
|
превышено ограничение программы
program_limit_exceeded
размер строки индекса 3200 превышает максимум 2704 для btree версии 4 у индекса "documents_body_idx" DETAIL: строка индекса ссылается на кортеж (12,3) в отношении "documents". HINT: значения больше 1/3 страницы буфера не могут быть проиндексированы. Рассмотрите функциональный индекс по MD5-хэшу значения или полнотекстовую индексацию.
|
54001
|
statement_too_complex
|
54011
|
too_many_columns
|
54023
|
too_many_arguments
|
Объект не находится в требуемом состоянии
| Код | Значение |
|---|---|
55000
|
объект не находится в требуемом состоянии
object_not_in_prerequisite_state
currval последовательности "orders_id_seq" ещё не определён в этой сессии
|
55006
|
объект используется
object_in_use
база данных "shop" используется другими пользователями DETAIL: Еще одна сессия использует эту базу данных.
|
55P02
|
cant_change_runtime_param
|
55P03
|
блокировка недоступна
lock_not_available
не удалось получить блокировку на строку в отношении "orders"
|
55P04
|
unsafe_new_enum_value_usage
|
Вмешательство оператора
| Код | Значение |
|---|---|
57000
|
operator_intervention
|
57014
|
отмена инструкции
query_canceled
отмена инструкции из-за истечения тайм-аута инструкции
|
57P01
|
прерывание соединения администратором
admin_shutdown
прерывание соединения по команде администратора
|
57P02
|
crash_shutdown
|
57P03
|
не удается подключиться сейчас
cannot_connect_now
система базы данных запускается
|
57P04
|
database_dropped
|
57P05
|
idle_session_timeout
|
Системная ошибка (ошибки, внешние по отношению к самому PostgreSQL)
| Код | Значение |
|---|---|
58000
|
system_error
|
58030
|
io_error
|
58P01
|
неопределенный файл
undefined_file
не удалось открыть файл "/tmp/orders.csv" для чтения: Нет такого файла или директории
|
58P02
|
duplicate_file
|
58P03
|
file_name_too_long
|
Ошибка файла конфигурации
| Код | Значение |
|---|---|
F0000
|
config_file_error
|
F0001
|
lock_file_exists
|
Ошибка обёртки внешних данных (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
|
Ошибка PL/pgSQL
| Код | Значение |
|---|---|
P0000
|
plpgsql_error
|
P0001
|
выбросить исключение
raise_exception
недостаточно средств на счете 42
|
P0002
|
no_data_found
|
P0003
|
too_many_rows
|
P0004
|
assert_failure
|
Внутренняя ошибка
| Код | Значение |
|---|---|
XX000
|
внутренняя ошибка
internal_error
не удалось найти запись в кэше для отношения 16397
|
XX001
|
данные повреждены
data_corrupted
неверная страница в блоке 1234 отношения base/16384/16397
|
XX002
|
index_corrupted
|
Другие базы данных
Более быстрый способ работы с PostgreSQL
SQLly — это нативный SQL-клиент для macOS, Windows и Linux с поддержкой IntelliSense, учитывающей схему базы данных, и защитой от опасных операций.