// PostgreSQL 错误参考

PostgreSQL 3F000:模式不存在

语句引用了当前数据库中不存在的模式,或者在 search_path 上不存在任何模式的情况下创建了对象。

SQLSTATE
3F000
名称
invalid_schema_name
类别
无效的模式名称
错误信息
schema "sales" does not exist

它的意思

模式是单个数据库中的命名空间。3F000 表示限定名称中命名的模式(sales.orders)或在 SET search_path 在你所连接的数据库中不存在。模式名的命名规则与其他标识符相同:不加引号的名称会转换为小写。

另一个相关的情况是 no schema has been selected to create in,当 CREATE TABLE 使用一个 search_path 且其中不包含任何存在的模式时。

常见原因

  • 该架构尚未在此数据库中创建(每个数据库都有自己的架构)。
  • 带引号的混合大小写模式名称,例如 "Sales" 无需引号即可引用。
  • 连接到了错误的数据库。
  • A search_path 仅命名不存在的模式。

如何修复它

  1. 列出此数据库中的模式。

    SELECT nspname FROM pg_namespace ORDER BY nspname;
  2. 创建模式,也可以选择由应用程序角色拥有。

    CREATE SCHEMA IF NOT EXISTS sales AUTHORIZATION app;
  3. 将搜索路径指向已存在的模式。

    SET search_path TO sales, public;

安全地复现它

SELECT * FROM no_such_schema.t;  -- ERROR: schema "no_such_schema" does not exist

相关错误

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

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

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