↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

百科 / SQL 状态码 / Class 42 语法错误或访问规则违反

42939 reserved_name

保留名称

ERROR 源码确认 详解 未实测

条件名
reserved_name
宏名称
ERRCODE_RESERVED_NAME
最早已知存在
7.4
状态
有效

版本覆盖

版本条依据已采样构建显示;灰色版本可能尚未采样,悬停可查看。手册链接随版本选择,源码和运行证据保持原核验构建。

速览

42939(reserved_name)按对象类型拒绝保留名称。选定的 18.6 路径覆盖模式、表空间、创建角色和角色说明语法;必须根据报文中的对象类型判断具体规则。

含义

创建模式时,保留的 pg_ 前缀会触发 unacceptable schema name "%s" 及系统模式 DETAIL;创建表空间有对应的系统表空间报文。CREATE ROLE 对 pg_ 前缀报告 role name "%s" is reserved。此外,语法中的 RoleId 在角色名位置拒绝 public、none、SESSION_USER、CURRENT_USER 和 CURRENT_ROLE:public、none 使用保留角色名主消息,后三个当前/会话标记使用 %s cannot be used as a role name here。这些规则不表示这些单词在所有标识符位置都保留。

诊断

先读取主消息和 DETAIL。unacceptable schema name 指向模式前缀检查,unacceptable tablespace name 指向表空间检查,role name ... is reserved 可能是 pg_ 角色或语法中的 public/none,%s cannot be used as a role name here 则明确是角色说明标记。语法错误应检查角色名所在的命令位置,而不是先查 pg_namespace 或 pg_authid;不能只凭 SQLSTATE 判断。

处理

选择允许的对象名称并检查迁移与所有权。若是角色说明语法错误,应在该位置改用允许的实际角色标识符;改 search_path 不能替代修正命令。不要删除系统对象或重复同名重试。对象级 ERROR 若发生在显式事务中,应先回滚到保存点或回滚事务再重试。

消息变体

选定路径均为 ERROR,具体主消息/DETAIL 如下:

  • 模式:unacceptable schema name "%s",DETAIL 为 The prefix "pg_" is reserved for system schemas.
  • 表空间:unacceptable tablespace name "%s",DETAIL 为 The prefix "pg_" is reserved for system tablespaces.
  • pg_ 角色:role name "%s" is reserved,DETAIL 为 Role names starting with "pg_" are reserved.
  • 角色语法:public/none 使用 role name "%s" is reserved,SESSION_USER、CURRENT_USER、CURRENT_ROLE 使用 %s cannot be used as a role name here。

报文模板

源码里的格式串,不是某一次运行的输出。%s 之类是占位符,实际报文会填入对象名与取值。适用范围一栏是核验时留下的原始英文记录,未经翻译。

主消息 unacceptable schema name "%s"
DETAIL The prefix "pg_" is reserved for system schemas.
主消息 · errdetail The prefix "pg_" is reserved for system schemas.

来源: 来源:src/backend/commands/schemacmds.c(lines 107-110) @ REL_18_6

适用范围:Placeholders remain dynamic source fields; no concrete runtime value is claimed.

主消息 unacceptable tablespace name "%s"
DETAIL The prefix "pg_" is reserved for system tablespaces.
主消息 · errdetail The prefix "pg_" is reserved for system tablespaces.

来源: 来源:src/backend/commands/tablespace.c(lines 281-285) @ REL_18_6

适用范围:Placeholders remain dynamic source fields; no concrete runtime value is claimed.

主消息 role name "%s" is reserved
DETAIL Role names starting with "pg_" are reserved.
主消息 · errdetail Role names starting with "pg_" are reserved.

来源: 来源:src/backend/commands/user.c(lines 352-356) @ REL_18_6

适用范围:Placeholders remain dynamic source fields; no concrete runtime value is claimed.

主消息 role name "%s" is reserved

来源: 来源:src/backend/parser/gram.y(lines 17460-17542) @ REL_18_6

适用范围:The grammar supplies public or none as the dynamic role-name value; no concrete command is claimed.

主消息 %s cannot be used as a role name here

来源: 来源:src/backend/parser/gram.y(lines 17460-17542) @ REL_18_6

适用范围:The grammar supplies SESSION_USER, CURRENT_USER, or CURRENT_ROLE as the dynamic token; no concrete command is claimed.

版本

目录锁定范围从 7.4 下界到 18.6、19beta3;这是条件目录下界,不是每个对象规则的共同引入版本。本页机制只做源码确认,未运行数据库。

来源

证据

断言

每条断言都写明了是怎么核实的,以及它不覆盖什么。这一层是核验时留下的原始英文记录,照原样呈现,未经翻译。

同类 SQL 状态码

状态码 条件名 宏名称 严重等级 版本
Class 42 语法错误或访问规则违反 Syntax Error or Access Rule Violation 44 个 ↗
42000 syntax_error_or_access_rule_violation ERRCODE_SYNTAX_ERROR_OR_ACCESS_RULE_VIOLATION ERROR 7.4 起已知
语法错误或访问规则违反的总类,见具体子码。 有效
42501 insufficient_privilege ERRCODE_INSUFFICIENT_PRIVILEGE ERROR 7.4 起已知
当前角色对目标对象的权限不足。 有效
42601 syntax_error ERRCODE_SYNTAX_ERROR ERROR 7.4 起已知
SQL 语句存在语法错误,解析器拒绝执行。 有效
42602 invalid_name ERRCODE_INVALID_NAME ERROR 7.4 起已知
名称不合法,如 enum 标签超出长度限制。 有效
42611 invalid_column_definition ERRCODE_INVALID_COLUMN_DEFINITION ERROR 7.4 起已知
列定义无效,如继承的父表默认值冲突。 有效
42622 name_too_long ERRCODE_NAME_TOO_LONG ERROR 7.4 起已知
标识符或 name 值超出长度上限。 有效
42701 duplicate_column ERRCODE_DUPLICATE_COLUMN ERROR 7.4 起已知
同一定义中重复指定了同名列。 有效
42702 ambiguous_column ERRCODE_AMBIGUOUS_COLUMN ERROR 7.4 起已知
列引用有歧义,多个表都有该列名。 有效
42703 undefined_column ERRCODE_UNDEFINED_COLUMN ERROR 7.4 起已知
引用的列在目标关系中不存在。 有效
42704 undefined_object ERRCODE_UNDEFINED_OBJECT ERROR 7.4 起已知
引用的数据库对象不存在,如触发器或类型。 有效
42710 duplicate_object ERRCODE_DUPLICATE_OBJECT ERROR 7.4 起已知
要定义的对象名已被占用,如重复 CREATE TYPE。 有效
42712 duplicate_alias ERRCODE_DUPLICATE_ALIAS ERROR 7.4 起已知
同一查询命名空间中重复使用了表别名。 有效
42723 duplicate_function ERRCODE_DUPLICATE_FUNCTION ERROR 7.4 起已知
同一模式下已存在同名同参数类型的函数。 有效
42725 ambiguous_function ERRCODE_AMBIGUOUS_FUNCTION ERROR 7.4 起已知
函数调用有多个候选,无法选出最佳匹配。 有效
42803 grouping_error ERRCODE_GROUPING_ERROR ERROR 7.4 起已知
分组查询输出了既未分组也未聚合的列。 有效
42804 datatype_mismatch ERRCODE_DATATYPE_MISMATCH ERROR 7.4 起已知
表达式类型与目标上下文要求的类型不符。 有效
42809 wrong_object_type ERRCODE_WRONG_OBJECT_TYPE ERROR 7.4 起已知
命令本身有效,但不能作用于该类对象。 有效
42830 invalid_foreign_key ERRCODE_INVALID_FOREIGN_KEY ERROR 7.4 起已知
外键在被引用列上找不到合格的唯一键。 有效
42846 cannot_coerce ERRCODE_CANNOT_COERCE ERROR 7.4 起已知
源类型到目标类型之间没有可用的 cast。 有效
42883 undefined_function ERRCODE_UNDEFINED_FUNCTION ERROR 7.4 起已知
按名称和参数类型找不到匹配的函数或操作符。 有效
428C9 generated_always ERRCODE_GENERATED_ALWAYS ERROR 10.0 起已知
向身份列或生成列赋值,这类列只接受 DEFAULT。 有效
42939 reserved_name ERRCODE_RESERVED_NAME ERROR 7.4 起已知
对象名使用了保留名称,如模式或表空间。 有效
42P01 undefined_table ERRCODE_UNDEFINED_TABLE ERROR 7.4 起已知
引用的表、视图或其他关系不存在。 有效
42P02 undefined_parameter ERRCODE_UNDEFINED_PARAMETER ERROR 7.4 起已知
查询引用了解析器未知的位置参数,如 $1。 有效
42P03 duplicate_cursor ERRCODE_DUPLICATE_CURSOR ERROR 7.4 起已知
游标或 portal 名称与已有的冲突。 有效
42P04 duplicate_database ERRCODE_DUPLICATE_DATABASE ERROR 7.4 起已知
集群中已存在同名数据库。 有效
42P05 duplicate_prepared_statement ERRCODE_DUPLICATE_PSTATEMENT ERROR 7.4 起已知
当前会话已有同名的服务端预备语句。 有效
42P06 duplicate_schema ERRCODE_DUPLICATE_SCHEMA ERROR 7.4 起已知
要创建的模式名在当前数据库中已存在。 有效
42P07 duplicate_table ERRCODE_DUPLICATE_TABLE ERROR 7.4 起已知
关系名已存在,或继承父项重复。 有效
42P08 ambiguous_parameter ERRCODE_AMBIGUOUS_PARAMETER ERROR 7.4 起已知
参数存在但无法推导出一致而具体的类型。 有效
42P09 ambiguous_alias ERRCODE_AMBIGUOUS_ALIAS ERROR 7.4 起已知
一个表引用对应多个关系命名空间项。 有效
42P10 invalid_column_reference ERRCODE_INVALID_COLUMN_REFERENCE ERROR 7.4 起已知
列引用不符合该操作的契约,如 COPY 生成列。 有效
42P11 invalid_cursor_definition ERRCODE_INVALID_CURSOR_DEFINITION ERROR 7.4 起已知
游标声明违反定义阶段规则,如 SCROLL 选项冲突。 有效
42P12 invalid_database_definition ERRCODE_INVALID_DATABASE_DEFINITION ERROR 7.4 起已知
数据库定义无效,核心源码中未见触发路径。 有效
42P13 invalid_function_definition ERRCODE_INVALID_FUNCTION_DEFINITION ERROR 7.4 起已知
函数、聚合或触发器声明在校验阶段失败。 有效
42P14 invalid_prepared_statement_definition ERRCODE_INVALID_PSTATEMENT_DEFINITION ERROR 7.4 起已知
PREPARE 定义预备语句时失败。 有效
42P15 invalid_schema_definition ERRCODE_INVALID_SCHEMA_DEFINITION ERROR 7.4 起已知
CREATE SCHEMA 的模式声明不一致被拒绝。 有效
42P16 invalid_table_definition ERRCODE_INVALID_TABLE_DEFINITION ERROR 7.4 起已知
表定义无效,如分区键或主键规则冲突。 有效
42P17 invalid_object_definition ERRCODE_INVALID_OBJECT_DEFINITION ERROR 7.4 起已知
对象定义无效,如继承、生成列或规则冲突。 有效
42P18 indeterminate_datatype ERRCODE_INDETERMINATE_DATATYPE ERROR 7.4 起已知
无法推断表达式或参数的数据类型。 有效
42P19 invalid_recursion ERRCODE_INVALID_RECURSION ERROR 8.4.0 起已知
递归查询结构不合法,执行前被检查拒绝。 有效
42P20 windowing_error ERRCODE_WINDOWING_ERROR ERROR 8.4.0 起已知
窗口函数调用或框架边界定义不合法。 有效
42P21 collation_mismatch ERRCODE_COLLATION_MISMATCH ERROR 9.1.0 起已知
参与运算的排序规则不兼容,产生冲突。 有效
42P22 indeterminate_collation ERRCODE_INDETERMINATE_COLLATION ERROR 9.1.0 起已知
操作需要唯一排序规则,但无法确定。 有效