PostgreSQL 42P01:关系不存在
PostgreSQL 找不到表、视图或序列。通常是 search_path 里的模式不对、用了带引号的混合大小写名称,或者连错了数据库。
- SQLSTATE
42P01- 名称
undefined_table
它的意思
在 PostgreSQL 中,关系是任何类似表的对象:表、视图、物化视图、序列、索引或外部表。42P01 表示你使用的名称无法解析为其中任何一种,查找范围是你的 search_path (或者在你显式指定的模式中)。
PostgreSQL 会把未加引号的名称转为小写。创建表时名为 "Orders" (引用,大写 O)只能被称为 "Orders",因此 SELECT * FROM Orders 寻找 orders 然后失败。
常见原因
- 该表所在的架构不在
search_path,例如sales.orders当路径是"$user", public. - 该表创建时用了带引号的混合大小写名称(ORM 和 GUI 工具里很常见),而查询没有给它加引号。
- 你连接的数据库与包含该表的数据库不同。PostgreSQL 无法使用普通名称跨数据库查询。
- 该表尚未创建:迁移失败了,或者迁移在另一个数据库中运行了。
- 表名有拼写错误。
如何修复它
-
检查你当前所在的位置以及搜索路径。
SELECT current_database(), current_schema(); SHOW search_path;
-
找到该表,无论其模式或大小写如何。
SELECT table_schema, table_name FROM information_schema.tables WHERE lower(table_name) = 'orders';
-
用其模式限定名称,或者将模式添加到搜索路径中。
SELECT * FROM sales.orders; SET search_path TO sales, public; -- permanently for a role: ALTER ROLE app SET search_path TO sales, public;
-
如果表是用大写字母创建的,请原样加上引号,或者将其重命名为小写,这样就不需要加引号了。
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 扩展,或者直接连到另一个数据库。
相关错误
42703列不存在3F000模式不存在3D000数据库不存在42501权限被拒绝208SQL Server:无效的对象名称1146MySQL:表不存在ORA-00942Oracle:表或视图不存在
更多语法错误或访问规则违例错误
42601语法错误,出现在或其附近42846无法强制转换42803列必须出现在 GROUP BY 子句中42830外键无效42804数据类型不匹配42P18无法确定参数的数据类型42883函数不存在42P02没有参数
代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.
在 SQLly 中使用 PostgreSQL
适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。