// справочник ошибок PostgreSQL

PostgreSQL 42830: недопустимый внешний ключ

Внешний ключ указывает на столбцы, которые не покрыты первичным ключом или уникальным ограничением в связанной таблице.

SQLSTATE
42830
Имя
invalid_foreign_key
Категория
Ошибка синтаксиса или нарушение правила доступа
Сообщение об ошибке
there is no unique constraint matching given keys for referenced table "customers"

Что это значит

Внешний ключ должен ссылаться на столбцы, которые гарантированно уникальны в родительской таблице через первичный ключ или UNIQUE ограничение (или уникальный индекс без предиката) ровно на те же столбцы. Иначе PostgreSQL не сможет определить, на какую родительскую строку ссылается дочерняя, и создание внешнего ключа завершится ошибкой 42830.

Столбцы должны совпадать как набор: уникальное ограничение на (tenant_id, id) не позволяет внешнему ключу ссылаться id в отдельности.

Распространённые причины

  • У ссылаемого столбца вообще нет ни первичного ключа, ни уникального ограничения.
  • Внешний ключ ссылается на подмножество или надмножество столбцов уникального ограничения.
  • Уникальный индекс на родительской таблице частичный (имеет WHERE ), на котором нельзя построить внешний ключ.

Как исправить

  1. Добавьте первичный ключ или уникальное ограничение на ссылаемые столбцы, затем создайте внешний ключ.

    ALTER TABLE customers ADD CONSTRAINT customers_email_key UNIQUE (email);
    ALTER TABLE orders ADD FOREIGN KEY (customer_email) REFERENCES customers (email);
  2. Или ссылайтесь на существующий ключ, используя тот же список столбцов.

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

Безопасное воспроизведение

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"

Связанные ошибки

Больше ошибок синтаксиса или нарушения правил доступа

Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с PostgreSQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.