// Referência de erro do PostgreSQL

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
Mensagem de erro
insert or update on table "orders" violates foreign key constraint "orders_customer_id_fkey"
DETAIL:  Key (customer_id)=(42) is not present in table "customers".

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 orders antes customers.
  • Um erro de digitação ou um id desatualizado na linha filha.
  • Excluindo uma linha pai que ainda possui filhos, sem ON DELETE CASCADE ou SET NULL na 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

  1. Encontre o pai ausente ou os filhos restantes.

    SELECT * FROM customers WHERE id = 42;
    SELECT * FROM orders WHERE customer_id = 42;
  2. 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
  3. 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;
  4. 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

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.

// menos erros, correções mais rápidas

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.