// PostgreSQL 錯誤參考

PostgreSQL 42710:重複的物件

CREATE 陳述式使用的名稱已被角色、條件約束、延伸模組、觸發程序、型別或其他非資料表物件佔用。

SQLSTATE
42710
名稱
duplicate_object
類別
語法錯誤或存取規則違反
錯誤訊息
role "app" already exists

它的意義

42710 (duplicate_object)是「已存在」錯誤,適用於資料表與其他關聯(42P07)、資料庫(42P04)、結構描述(42P06)與函式(42723)以外的物件。典型訊息如 role "app" already exists, constraint "orders_pkey" for relation "orders" already exists, extension "pgcrypto" already exists 和 trigger "set_updated_at" for relation "orders" already exists.

這幾乎總是代表有設定或遷移腳本被執行了第二次。

常見原因

  • 重新執行建立角色、擴充功能或類型的設定腳本。
  • 某次遷移要新增的約束或觸發器,已由更早的遷移或手動變更加入過。
  • 將傾印檔還原到物件已存在的資料庫或叢集。

如何修正

  1. 使用 IF NOT EXISTS 在指令支援的情況下。

    CREATE EXTENSION IF NOT EXISTS pgcrypto;
    CREATE TABLE IF NOT EXISTS t (id int);
  2. 角色、條件約束與型別沒有 IF NOT EXISTS;先在 DO 區塊。

    DO $$
    BEGIN
        IF NOT EXISTS (SELECT FROM pg_roles WHERE rolname = 'app') THEN
            CREATE ROLE app LOGIN;
        END IF;
    END;
    $$;
  3. 觸發器可以直接原地取代(PostgreSQL 14 及更新版本)。

    CREATE OR REPLACE TRIGGER set_updated_at
        BEFORE UPDATE ON orders
        FOR EACH ROW EXECUTE FUNCTION touch_updated_at();

安全地重現問題

CREATE EXTENSION plpgsql;  -- ERROR: extension "plpgsql" already exists

相關錯誤

更多語法錯誤或存取規則違規錯誤

程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

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