PostgreSQL 23503: violação de restrição de chave estrangeira
Uma linha faz referência a uma chave pai que não existe, ou você deletou ou alterou uma linha pai que ainda é referenciada por linhas filho.
- SQLSTATE
23503- Nome
foreign_key_violation- Categoria
- Violação de restrição de integridade
O que significa
Uma chave estrangeira diz que todo valor na coluna filho deve existir na coluna referenciada (pai). O PostgreSQL gera 23503 em duas situações: quando você insere ou atualiza uma linha filho cuja chave não tem pai (is not present in table), e quando você deleta ou atualiza uma linha pai que ainda é apontada por linhas filho (is still referenced from table).
O DETAIL linha fornece o valor da chave e a outra tabela, assim você sabe quais linhas verificar.
Causas comuns
- Inserindo linhas filho antes das linhas pai, por exemplo ao carregar
ordersantescustomers. - Um erro de digitação ou um id desatualizado na linha filha.
- Excluindo uma linha pai que ainda possui filhos, sem
ON DELETE CASCADEouSET NULLna chave estrangeira. - Atualizando a chave primária de um pai enquanto os filhos ainda referenciam o valor antigo.
- Duas transações: uma insere um filho para um pai que outra acabou de excluir.
Como corrigir
-
Encontre o pai ausente ou os filhos restantes.
SELECT * FROM customers WHERE id = 42; SELECT * FROM orders WHERE customer_id = 42;
-
Insira os pais primeiro, ou carregue ambas as tabelas em uma transação com a restrição adiada (ela deve ser declarada
DEFERRABLE).ALTER TABLE orders ALTER CONSTRAINT orders_customer_id_fkey DEFERRABLE INITIALLY IMMEDIATE; BEGIN; SET CONSTRAINTS orders_customer_id_fkey DEFERRED; INSERT INTO orders (id, customer_id) VALUES (1, 42); INSERT INTO customers (id, name) VALUES (42, 'Ada'); COMMIT; -- checked here
-
Ao excluir um pai, exclua ou reatribua seus filhos primeiro, ou altere a regra de exclusão da chave estrangeira se esse for o comportamento desejado.
ALTER TABLE orders DROP CONSTRAINT orders_customer_id_fkey, ADD CONSTRAINT orders_customer_id_fkey FOREIGN KEY (customer_id) REFERENCES customers (id) ON DELETE CASCADE; -
Encontre as linhas órfãs antes de adicionar uma chave estrangeira a dados existentes.
SELECT o.* FROM orders o LEFT JOIN customers c ON c.id = o.customer_id WHERE o.customer_id IS NOT NULL AND c.id IS NULL;
Reproduza com segurança
CREATE TEMP TABLE p (id int PRIMARY KEY); CREATE TEMP TABLE c (p_id int REFERENCES p (id)); INSERT INTO c VALUES (1); -- ERROR: ... violates foreign key constraint "c_p_id_fkey"
Erros relacionados
23505chave duplicada viola a restrição única23502valor nulo viola a restrição de não nulo42830chave estrangeira inválida2BP01objetos dependentes ainda existem547SQL Server: A instrução entrou em conflito com uma restrição1452MySQL: falha na chave estrangeira: não é possível adicionar a linha filha1451MySQL: falha na chave estrangeira: não é possível excluir a linha paiORA-02291Oracle: violação de restrição de integridade - chave pai não encontradaORA-02292Oracle: violação de restrição de integridade - registro filho encontradoSQLITE_CONSTRAINT_FOREIGNKEYSQLite: Falha na restrição FOREIGN KEY
Mais erros de violação de restrição de integridade
O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.
Trabalhe com PostgreSQL no SQLly
Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.