// 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 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。