Códigos de erro do PostgreSQL
Cada código SQLSTATE que o PostgreSQL pode gerar, agrupado por classe conforme o apêndice oficial. Os que as pessoas realmente encontram têm uma página completa: o que o erro significa, por que acontece e como corrigir.
Lendo um erro do PostgreSQL
O PostgreSQL identifica cada erro por um código SQLSTATE de cinco caracteres. Os dois primeiros caracteres são a classe: 23 é violação de restrição de integridade, 42 é erro de sintaxe ou violação de regra de acesso, 40 é rollback de transação, e assim por diante. Códigos que terminam em 000 são o código genérico da sua classe.
psql mostra a mensagem, não o código. Execute \set VERBOSITY verbose para ver o SQLSTATE, ou lê-lo no seu driver: SQLSTATE em JDBC e ODBC, e.pgcode no psycopg2, e.sqlstate no psycopg 3, err.code no node-postgres.
No PL/pgSQL, você pode capturar um erro pelo nome da condição (EXCEPTION WHEN unique_violation THEN) ou pelo código (WHEN SQLSTATE '23505' THEN).
Todos os erros do PostgreSQL nesta referência
262 códigos, 63 com uma descrição completa (com link). Códigos e mensagens são da documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL.
Conclusão bem-sucedida
| Código | Significado |
|---|---|
00000
|
successful_completion
|
Aviso
| Código | Significado |
|---|---|
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
|
Sem Dados (esta também é uma classe de aviso segundo o padrão SQL)
| Código | Significado |
|---|---|
02000
|
no_data
|
02001
|
no_additional_dynamic_result_sets_returned
|
Instrução SQL ainda não concluída
| Código | Significado |
|---|---|
03000
|
sql_statement_not_yet_complete
|
Exceção de conexão
| Código | Significado |
|---|---|
08000
|
connection_exception
|
08003
|
connection_does_not_exist
|
08006
|
falha de conexão
connection_failure
o servidor fechou a conexão inesperadamente Isso provavelmente significa que o servidor terminou de forma anormal antes ou durante o processamento da solicitação.
|
08001
|
não foi possível estabelecer a conexão
sqlclient_unable_to_establish_sqlconnection
a conexão com o servidor em "db.example.com" (10.0.0.5), porta 5432 falhou: Conexão recusada O servidor está em execução nesse host e aceitando conexões TCP/IP?
|
08004
|
sqlserver_rejected_establishment_of_sqlconnection
|
08007
|
transaction_resolution_unknown
|
08P01
|
protocol_violation
|
Exceção de Ação Disparada
| Código | Significado |
|---|---|
09000
|
triggered_action_exception
|
Recurso não suportado
| Código | Significado |
|---|---|
0A000
|
recurso não suportado
feature_not_supported
referências entre bancos de dados não estão implementadas: "otherdb.public.orders"
|
Início de transação inválido
| Código | Significado |
|---|---|
0B000
|
invalid_transaction_initiation
|
Exceção de localizador
| Código | Significado |
|---|---|
0F000
|
locator_exception
|
0F001
|
invalid_locator_specification
|
Concedente inválido
| Código | Significado |
|---|---|
0L000
|
invalid_grantor
|
0LP01
|
invalid grant operation
invalid_grant_operation
as opções de concessão só podem ser concedidas a papéis
|
Especificação de função inválida
| Código | Significado |
|---|---|
0P000
|
invalid_role_specification
|
Exceção de Diagnóstico
| Código | Significado |
|---|---|
0Z000
|
diagnostics_exception
|
0Z002
|
stacked_diagnostics_accessed_without_active_handler
|
Erro de XQuery
| Código | Significado |
|---|---|
10608
|
invalid_argument_for_xquery
|
Caso não encontrado
| Código | Significado |
|---|---|
20000
|
case_not_found
|
Violação de cardinalidade
| Código | Significado |
|---|---|
21000
|
mais de uma linha retornada por uma subconsulta
cardinality_violation
mais de uma linha retornada por uma subconsulta usada como uma expressão
|
Exceção de dados
| Código | Significado |
|---|---|
22000
|
data_exception
|
2202E
|
array_subscript_error
|
22021
|
sequência de bytes inválida para a codificação
character_not_in_repertoire
sequência de bytes inválida para a codificação "UTF8": 0xff
|
22008
|
valor do campo data/hora fora do intervalo
datetime_field_overflow
valor do campo data/hora fora do intervalo: «2026-13-01»
|
22012
|
divisão por zero
division_by_zero
divisão por 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
|
formato de data/hora inválido
invalid_datetime_format
sintaxe de entrada inválida para o tipo 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
|
valor de parâmetro inválido
invalid_parameter_value
valor inválido para o parâmetro "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
|
valor numérico fora do intervalo
numeric_value_out_of_range
inteiro fora do intervalo
|
2200H
|
sequence_generator_limit_exceeded
|
22026
|
string_data_length_mismatch
|
22001
|
valor muito longo para o tipo
string_data_right_truncation
valor muito longo para o tipo character varying(20)
|
22011
|
substring_error
|
22027
|
trim_error
|
22024
|
unterminated_c_string
|
2200F
|
zero_length_character_string
|
22P01
|
floating_point_exception
|
22P02
|
sintaxe de entrada inválida para o tipo
invalid_text_representation
sintaxe de entrada inválida para o tipo inteiro: "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
|
Violação de restrição de integridade
| Código | Significado |
|---|---|
23000
|
integrity_constraint_violation
|
23001
|
restrict_violation
|
23502
|
valor nulo viola a restrição de não nulo
not_null_violation
valor nulo na coluna "email" da relação "users" viola a restrição de não nulo DETALHE: A linha com falha contém (7, Ada, nulo).
|
23503
|
violação de restrição de chave estrangeira
foreign_key_violation
inserção ou atualização na tabela "orders" viola a restrição de chave estrangeira "orders_customer_id_fkey" DETALHE: Chave (customer_id)=(42) não está presente na tabela "customers".
|
23505
|
chave duplicada viola a restrição única
unique_violation
o valor da chave duplicada viola a restrição única «users_email_key» DETALHE: Chave (email)=([email protected]) já existe.
|
23514
|
violação de restrição de verificação
check_violation
nova linha para a relação "orders" viola a restrição de verificação "orders_qty_check" DETALHE: A linha que falhou contém (12, -1).
|
23P01
|
violação de restrição de exclusão
exclusion_violation
valor de chave conflitante viola a restrição de exclusão "bookings_room_during_excl" DETALHE: Chave (room_id, during)=(4, ["2026-05-01 10:00:00","2026-05-01 11:00:00")) entra em conflito com a chave existente (room_id, during)=(4, ["2026-05-01 10:30:00","2026-05-01 12:00:00")).
|
Estado de cursor inválido
| Código | Significado |
|---|---|
24000
|
invalid_cursor_state
|
Estado de transação inválido
| Código | Significado |
|---|---|
25000
|
invalid_transaction_state
|
25001
|
não pode ser executado dentro de um bloco de transação
active_sql_transaction
CREATE INDEX CONCURRENTLY não pode ser executado dentro de um bloco de transação
|
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
|
transação SQL somente leitura
read_only_sql_transaction
não é possível executar INSERT em uma transação somente leitura
|
25007
|
schema_and_data_statement_mixing_not_supported
|
25P01
|
no_active_sql_transaction
|
25P02
|
a transação atual foi abortada
in_failed_sql_transaction
a transação atual foi abortada, comandos ignorados até o final do bloco de transação
|
25P03
|
tempo limite de sessão ociosa em transação
idle_in_transaction_session_timeout
encerrando a conexão devido ao tempo limite de idle-in-transaction
|
25P04
|
transaction_timeout
|
Nome de instrução SQL inválido
| Código | Significado |
|---|---|
26000
|
invalid_sql_statement_name
|
Violação de Alteração de Dados Disparada
| Código | Significado |
|---|---|
27000
|
triggered_data_change_violation
|
Especificação de autorização inválida
| Código | Significado |
|---|---|
28000
|
especificação de autorização inválida
invalid_authorization_specification
nenhuma entrada pg_hba.conf para o host "10.0.0.5", usuário "app", banco de dados "shop", sem criptografia
|
28P01
|
autenticação de senha falhou
invalid_password
autenticação de senha falhou para o usuário "app"
|
Descritores de privilégio dependentes ainda existem
| Código | Significado |
|---|---|
2B000
|
dependent_privilege_descriptors_still_exist
|
2BP01
|
objetos dependentes ainda existem
dependent_objects_still_exist
não é possível excluir a tabela customers porque outros objetos dependem dela DETALHE: a restrição orders_customer_id_fkey na tabela orders depende da tabela customers DICA: Use DROP ... CASCADE para excluir também os objetos dependentes.
|
Encerramento de transação inválido
| Código | Significado |
|---|---|
2D000
|
terminação de transação inválida
invalid_transaction_termination
terminação de transação inválida
|
Exceção de Rotina SQL
| Código | Significado |
|---|---|
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
|
Nome de cursor inválido
| Código | Significado |
|---|---|
34000
|
invalid_cursor_name
|
Exceção de rotina externa
| Código | Significado |
|---|---|
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
|
Exceção de invocação de rotina externa
| Código | Significado |
|---|---|
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
|
Exceção de savepoint
| Código | Significado |
|---|---|
3B000
|
savepoint_exception
|
3B001
|
especificação de ponto de salvamento inválida
invalid_savepoint_specification
o ponto de salvamento "before_update" não existe
|
Nome de catálogo inválido
| Código | Significado |
|---|---|
3D000
|
o banco de dados não existe
invalid_catalog_name
banco de dados "shop" não existe
|
Nome de esquema inválido
| Código | Significado |
|---|---|
3F000
|
o esquema não existe
invalid_schema_name
o esquema "sales" não existe
|
Rollback de Transação
| Código | Significado |
|---|---|
40000
|
transaction_rollback
|
40002
|
transaction_integrity_constraint_violation
|
40001
|
não foi possível serializar o acesso
serialization_failure
não foi possível serializar o acesso devido a atualização concorrente
|
40003
|
statement_completion_unknown
|
40P01
|
deadlock detectado
deadlock_detected
deadlock detectado DETALHE: Processo 1234 espera por ShareLock na transação 5678; bloqueado pelo processo 4321. Processo 4321 espera por ShareLock na transação 8765; bloqueado pelo processo 1234.
|
Erro de sintaxe ou violação de regra de acesso
| Código | Significado |
|---|---|
42000
|
syntax_error_or_access_rule_violation
|
42601
|
erro de sintaxe próximo a
syntax_error
erro de sintaxe próximo a "FROM" LINHA 1: SELECT id, name, FROM users; ^
|
42501
|
permissão negada
insufficient_privilege
permissão negada para a tabela orders
|
42846
|
não é possível converter
cannot_coerce
não é possível converter tipo integer para uuid
|
42803
|
a coluna deve aparecer na cláusula GROUP BY
grouping_error
a coluna "o.customer_id" deve aparecer na cláusula GROUP BY ou ser usada em uma função agregada
|
42P20
|
windowing_error
|
42P19
|
invalid_recursion
|
42830
|
chave estrangeira inválida
invalid_foreign_key
não existe uma restrição única correspondente às chaves fornecidas para a tabela referenciada "customers"
|
42602
|
invalid_name
|
42622
|
name_too_long
|
42939
|
reserved_name
|
42804
|
incompatibilidade de tipo de dado
datatype_mismatch
a coluna "created_at" é do tipo timestamp com fuso horário, mas a expressão é do tipo inteiro DICA: Você precisará reescrever ou converter a expressão.
|
42P18
|
não foi possível determinar o tipo de dado do parâmetro
indeterminate_datatype
não foi possível determinar o tipo de dado do parâmetro $1
|
42P21
|
collation_mismatch
|
42P22
|
indeterminate_collation
|
42809
|
wrong_object_type
|
428C9
|
generated_always
|
42703
|
a coluna não existe
undefined_column
a coluna "emial" não existe LINHA 1: SELECT emial FROM users; ^ DICA: Talvez você quisesse referenciar a coluna "users.email".
|
42883
|
função não existe
undefined_function
função lower(integer) não existe LINHA 1: SELECT lower(42); ^ SUGESTÃO: Nenhuma função corresponde ao nome e tipos de argumentos fornecidos. Você pode precisar adicionar conversões de tipo explícitas.
|
42P01
|
relação não existe
undefined_table
relação "orders" não existe LINHA 1: SELECT * FROM orders; ^
|
42P02
|
não há parâmetro
undefined_parameter
não há parâmetro $1
|
42704
|
objeto indefinido
undefined_object
tipo "jsonbb" não existe
|
42701
|
duplicate_column
|
42P03
|
duplicate_cursor
|
42P04
|
o banco de dados já existe
duplicate_database
o banco de dados «shop» já existe
|
42723
|
duplicate_function
|
42P05
|
duplicate_prepared_statement
|
42P06
|
esquema já existe
duplicate_schema
esquema "sales" já existe
|
42P07
|
relação já existe
duplicate_table
relação "orders" já existe
|
42712
|
duplicate_alias
|
42710
|
objeto duplicado
duplicate_object
função "app" já existe
|
42702
|
referência de coluna é ambígua
ambiguous_column
referência de coluna "id" é ambígua LINHA 1: SELECT id FROM orders JOIN customers ON customers.id = orders.customer_id; ^
|
42725
|
ambiguous_function
|
42P08
|
ambiguous_parameter
|
42P09
|
ambiguous_alias
|
42P10
|
referência de coluna inválida
invalid_column_reference
não há restrição única ou de exclusão correspondente à especificação 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
|
Violação de WITH CHECK OPTION
| Código | Significado |
|---|---|
44000
|
with_check_option_violation
|
Recursos insuficientes
| Código | Significado |
|---|---|
53000
|
insufficient_resources
|
53100
|
disco cheio
disk_full
não foi possível estender o arquivo "base/16384/16397": Sem espaço disponível no dispositivo DICA: Verifique o espaço livre no disco.
|
53200
|
sem memória
out_of_memory
sem memória DETALHE: Falha na solicitação de tamanho 1048576 no contexto de memória "ExecutorState".
|
53300
|
muitas conexões
too_many_connections
desculpe, já há clientes demais
|
53400
|
configuration_limit_exceeded
|
Limite de Programa Excedido
| Código | Significado |
|---|---|
54000
|
limite de programa excedido
program_limit_exceeded
tamanho da linha de índice 3200 excede o máximo de 2704 da versão 4 do btree para o índice "documents_body_idx" DETALHE: A linha do índice referencia a tupla (12,3) na relação "documents". DICA: Valores maiores que 1/3 de uma página de buffer não podem ser indexados. Considere um índice funcional com o hash MD5 do valor, ou use indexação de texto completo.
|
54001
|
statement_too_complex
|
54011
|
too_many_columns
|
54023
|
too_many_arguments
|
O objeto não está no estado de pré-requisito
| Código | Significado |
|---|---|
55000
|
objeto não está no estado pré-requisito
object_not_in_prerequisite_state
currval da sequência "orders_id_seq" ainda não está definido nesta sessão
|
55006
|
objeto em uso
object_in_use
o banco de dados «shop» está sendo acessado por outros usuários DETALHE: Há 1 outra sessão usando o banco de dados.
|
55P02
|
cant_change_runtime_param
|
55P03
|
bloqueio não disponível
lock_not_available
não foi possível obter bloqueio na linha na relação "orders"
|
55P04
|
unsafe_new_enum_value_usage
|
Intervenção do operador
| Código | Significado |
|---|---|
57000
|
operator_intervention
|
57014
|
cancelando instrução
query_canceled
cancelando instrução devido ao tempo limite da instrução
|
57P01
|
encerrando a conexão devido ao administrador
admin_shutdown
encerrando a conexão devido a um comando do administrador
|
57P02
|
crash_shutdown
|
57P03
|
não é possível conectar agora
cannot_connect_now
o sistema de banco de dados está iniciando
|
57P04
|
database_dropped
|
57P05
|
idle_session_timeout
|
Erro do sistema (erros externos ao próprio PostgreSQL)
| Código | Significado |
|---|---|
58000
|
system_error
|
58030
|
io_error
|
58P01
|
arquivo indefinido
undefined_file
não foi possível abrir o arquivo "/tmp/orders.csv" para leitura: Arquivo ou diretório não existe
|
58P02
|
duplicate_file
|
58P03
|
file_name_too_long
|
Erro de Arquivo de Configuração
| Código | Significado |
|---|---|
F0000
|
config_file_error
|
F0001
|
lock_file_exists
|
Erro de Foreign Data Wrapper (SQL/MED)
| Código | Significado |
|---|---|
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
|
Erro PL/pgSQL
| Código | Significado |
|---|---|
P0000
|
plpgsql_error
|
P0001
|
gerar exceção
raise_exception
fundos insuficientes para a conta 42
|
P0002
|
no_data_found
|
P0003
|
too_many_rows
|
P0004
|
assert_failure
|
Erro interno
| Código | Significado |
|---|---|
XX000
|
erro interno
internal_error
falha na busca no cache para a relação 16397
|
XX001
|
dados corrompidos
data_corrupted
página inválida no bloco 1234 da relação base/16384/16397
|
XX002
|
index_corrupted
|
Outros bancos de dados
Uma forma mais rápida de trabalhar com PostgreSQL
O SQLly é um cliente SQL nativo para macOS, Windows e Linux, com IntelliSense baseado no esquema e proteções para instruções arriscadas.