// PostgreSQL 错误参考

PostgreSQL 42P07:关系已存在

CREATE TABLE、INDEX、VIEW 或 SEQUENCE 使用的名称在该模式中已被某个表类对象占用。

SQLSTATE
42P07
名称
duplicate_table
类别
语法错误或访问规则违规
错误信息
relation "orders" already exists

它的意思

表、视图、物化视图、序列、索引和外部表在每个模式中共享一个命名空间。用该模式中已被占用的名称创建其中任何一种对象都会失败并报 42P07 错误,即使现有对象是另一种类型(例如某个索引与表同名)。

重新运行迁移或设置脚本是常见触发原因。

常见原因

  • 之前部分或完整运行过的安装或迁移脚本。
  • 名称与模式中现有的表、视图或索引相同的索引。
  • 两个迁移创建了同一个对象。
  • 同一会话中残留的临时表。

如何修复它

  1. 让脚本具备幂等性,方法是用 IF NOT EXISTS.

    CREATE TABLE IF NOT EXISTS orders (id bigint PRIMARY KEY);
    CREATE INDEX IF NOT EXISTS orders_created_at_idx ON orders (created_at);
  2. 查看当前占用该名称的对象。

    SELECT n.nspname, c.relname, c.relkind
    FROM pg_class c JOIN pg_namespace n ON n.oid = c.relnamespace
    WHERE c.relname = 'orders';
  3. 如果要替换旧对象,请先确认没有对象依赖它,然后再删除。

    DROP TABLE IF EXISTS orders_old;
    CREATE OR REPLACE VIEW order_summary AS SELECT 1 AS n;  -- views can be replaced in place

安全地复现它

CREATE TEMP TABLE t (id int);
CREATE TEMP TABLE t (id int);  -- ERROR: relation "t" already exists

相关错误

更多语法错误或访问规则违例错误

代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。