// PostgreSQL 错误参考

PostgreSQL 42P01:关系不存在

PostgreSQL 找不到表、视图或序列。通常是 search_path 里的模式不对、用了带引号的混合大小写名称,或者连错了数据库。

SQLSTATE
42P01
名称
undefined_table
类别
语法错误或访问规则违规
错误信息
relation "orders" does not exist
LINE 1: SELECT * FROM orders;
                      ^

它的意思

在 PostgreSQL 中,关系是任何类似表的对象:表、视图、物化视图、序列、索引或外部表。42P01 表示你使用的名称无法解析为其中任何一种,查找范围是你的 search_path (或者在你显式指定的模式中)。

PostgreSQL 会把未加引号的名称转为小写。创建表时名为 "Orders" (引用,大写 O)只能被称为 "Orders",因此 SELECT * FROM Orders 寻找 orders 然后失败。

常见原因

  • 该表所在的架构不在 search_path,例如 sales.orders 当路径是 "$user", public.
  • 该表创建时用了带引号的混合大小写名称(ORM 和 GUI 工具里很常见),而查询没有给它加引号。
  • 你连接的数据库与包含该表的数据库不同。PostgreSQL 无法使用普通名称跨数据库查询。
  • 该表尚未创建:迁移失败了,或者迁移在另一个数据库中运行了。
  • 表名有拼写错误。

如何修复它

  1. 检查你当前所在的位置以及搜索路径。

    SELECT current_database(), current_schema();
    SHOW search_path;
  2. 找到该表,无论其模式或大小写如何。

    SELECT table_schema, table_name
    FROM information_schema.tables
    WHERE lower(table_name) = 'orders';
  3. 用其模式限定名称,或者将模式添加到搜索路径中。

    SELECT * FROM sales.orders;
    SET search_path TO sales, public;
    -- permanently for a role:
    ALTER ROLE app SET search_path TO sales, public;
  4. 如果表是用大写字母创建的,请原样加上引号,或者将其重命名为小写,这样就不需要加引号了。

    SELECT * FROM "Orders";
    ALTER TABLE "Orders" RENAME TO orders;

安全地复现它

SELECT * FROM table_that_does_not_exist;  -- ERROR: relation "table_that_does_not_exist" does not exist

问题

表是存在的,那为什么 PostgreSQL 会说关系不存在?

几乎总是模式或大小写的问题:要么表所在的模式不在你的 search_path 中,要么它创建时用了带引号的大小写混合名称,必须以同样的方式加引号。用 lower(table_name) 查询 information_schema.tables,就能看到它实际所在的模式和名称写法。

我可以查询另一个数据库中的表吗?

不能直接。每个 PostgreSQL 连接只对应一个数据库。可以使用 postgres_fdw 或 dblink 扩展,或者直接连到另一个数据库。

相关错误

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

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

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

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