// Referência de erro do PostgreSQL

PostgreSQL 42830: chave estrangeira inválida

Uma chave estrangeira aponta para colunas que não estão cobertas por uma chave primária ou restrição única na tabela referenciada.

SQLSTATE
42830
Nome
invalid_foreign_key
Categoria
Erro de sintaxe ou violação de regra de acesso
Mensagem de erro
there is no unique constraint matching given keys for referenced table "customers"

O que significa

Uma chave estrangeira deve referenciar colunas que são garantidamente únicas na tabela pai, através de sua chave primária ou um UNIQUE restrição (ou um índice único sem um predicado) exatamente nessas colunas. Caso contrário, o PostgreSQL não consegue identificar a qual linha pai uma linha filha se refere, e a criação da chave estrangeira falha com 42830.

As colunas devem corresponder como um conjunto: uma restrição única em (tenant_id, id) não permite que uma chave estrangeira faça referência a id individualmente.

Causas comuns

  • A coluna referenciada não tem chave primária nem restrição de unicidade.
  • A chave estrangeira referencia um subconjunto ou superconjunto das colunas da restrição única.
  • O índice único no pai é parcial (tem uma WHERE cláusula), que não pode dar suporte a uma chave estrangeira.

Como corrigir

  1. Adicione uma chave primária ou restrição única nas colunas referenciadas, e então crie a chave estrangeira.

    ALTER TABLE customers ADD CONSTRAINT customers_email_key UNIQUE (email);
    ALTER TABLE orders ADD FOREIGN KEY (customer_email) REFERENCES customers (email);
  2. Ou faça referência à chave existente, usando a mesma lista de colunas.

    ALTER TABLE orders
        ADD FOREIGN KEY (tenant_id, customer_id) REFERENCES customers (tenant_id, id);

Reproduza com segurança

CREATE TEMP TABLE p (id int);
CREATE TEMP TABLE c (p_id int REFERENCES p (id));  -- ERROR: there is no unique constraint matching given keys for referenced table "p"

Erros relacionados

Mais erros de sintaxe ou violação de regra de acesso

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.