// 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 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。