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

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

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

42611 invalid_column_definition

列定义无效

ERROR 已实测 参考 实测通过

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

手册收录:8.1、8.2、8.3、8.4、9.0、9.1、9.2、9.3、9.4、9.5、9.6、10、11、12、13、14、15、16、17、18、19、20。此处仅表示同版本手册收录,运行证据仍以原核验构建为准。

版本覆盖

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

42611 — 列定义无效

速览 {#at-a-glance}

SQLSTATE 42611 是 Class 42 中的 invalid_column_definition。42611 表示列定义无效。选定案例中的两个继承父表为 id 定义了不同默认值;子表 DDL 失败并报告 column "%s" inherits conflicting default values,提示显式指定默认值。

含义 {#meaning}

42611 表示列定义无效。在 MergeAttributes 中,PostgreSQL 按父表顺序合并同名列。如果继承来的默认表达式不相等,且子表没有覆盖它,最终检查会发出 ERROR:column "%s" inherits conflicting default values,并提示显式指定默认值。选定案例的两个父表为 id 定义了不同默认值。

诊断 {#diagnosis}

检查 INHERITS 列表中的每个父表,比较同名列的类型、排序规则、可空性和默认表达式。相同默认值可以合并;子表本地默认值可以覆盖继承冲突。选定 DDL 的 ERROR 后自动提交会话仍为 IDLE;这是继承默认值分支,不是一般的重复列错误,也不是类型/排序规则冲突。

处理 {#response}

按服务器提示在子表定义中显式声明预期默认值,然后插入 DEFAULT VALUES 并核对结果。如果父表本应一致,应直接修复父表迁移;如果差异是有意的,就把子表覆盖值明确写在 DDL 中。选定修复返回 1,但这是案例值,不代表所有场景都应选择同一策略。

报文 {#messages}

选定源码分支以明确的 ERROR 发出主报文 column "%s" inherits conflicting default values 和 HINT To resolve the conflict, specify a default explicitly. %s 是冲突列名。只有客户端异常而没有服务器 SQLSTATE、主报文和 HINT 时,不能据此识别这个选定的继承默认值子路径;其他固定 producer 可以使用同一 SQLSTATE 和不同诊断。

代表案例 {#case}

本页使用与运行器注册表相同的语句。执行时,syntax_schema、syntax_role 等生成名称会替换为一次性实例中的实际值。

CREATE TABLE syntax_schema.parent_one (id integer DEFAULT 1);
CREATE TABLE syntax_schema.parent_two (id integer DEFAULT 2);
CREATE TABLE syntax_schema.child_bad () INHERITS (syntax_schema.parent_one, syntax_schema.parent_two);
CREATE TABLE syntax_schema.child_good (id integer DEFAULT 1) INHERITS (syntax_schema.parent_one, syntax_schema.parent_two);
INSERT INTO syntax_schema.child_good DEFAULT VALUES RETURNING id;

选定的 18.6 运行记录结构化诊断并通过修复断言;10.21 运行通过同一案例的具体检查。可下载的案例和证据投影分别是 42611 案例 JSON 和 作者证据。运行器清单为 verify/cases/42611/cases.json,页面 SQL 会与共享注册表核对。

版本 {#versions}

选定的自然运行范围是 PostgreSQL 18.6 与 10.21,不能据此推断所有中间版本的行为。

相关 {#related}

来源 {#sources}

  • src.errcodes.18.6 — fixed errcodes.txt definition at commit 724edf9bde9d356724ad384a2e196edc3c9f80f7; SHA-256 6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba (source).
  • src.inherited-conflicting-default.18.6 — src/backend/commands/tablecmds.c at REL_18_6 commit 724edf9bde9d356724ad384a2e196edc3c9f80f7; fixed blob SHA-256 422dc8e833df4940755973c757e338295822ba3e4c7266c40669f49f96eb15a9 (source).
  • src.inherited-conflicting-default.10.23 — src/backend/commands/tablecmds.c at REL_10_23 commit 02991e79f8f58bc208f05dcc8af0c62dbe0a6ea4; fixed blob SHA-256 6de441c88496c6cf57a836898388085ec08bf69afd70d07acdafd6089b9b5f8c (source).
  • src.calls.REL_18_6 / src.calls.REL_10_23 — fixed call scans, SHA-256 9ee8a0e81d8f0825c5c1ae45583439859a26e602bdd4ce2f2a62aa278867ccbf / 00d16d3eb01b71ccf1b245c8f3102f9d0ec9f36fb02777b8dd1b99fcb263040c.

来源

证据

断言

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

运行记录

目标服务器版本结果覆盖案例
latest 18.6 (Homebrew) passed
pg10 10.21 (Debian 10.21-1.pgdg90+1) passed

报文模板

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

主消息 column "%s" inherits conflicting default values
HINT To resolve the conflict, specify a default explicitly.

来源: 来源:src/backend/commands/tablecmds.c @ REL_18_6 · 来源:src/backend/commands/tablecmds.c @ REL_10_23

可复现案例

在一次性实例上执行过的场景。其中 1 个附有可执行 SQL,正文相应小节里给出。

conflicting_inherited_default PG 10 / 18 有 SQL

前置条件

  • A runner-owned disposable target is provisioned.

触发

Create two parent tables with different defaults and inherit both without an explicit child default.

断言

  • SQLSTATE is 42611 with the conflicting-default diagnostic
  • The session remains IDLE
  • An explicit child default resolves the inheritance conflict and DEFAULT inserts 1

处置

Specify the intended default explicitly on the child definition, then verify the inherited table.

清理

Drop the case schema with an owner connection.

同类 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 起已知
操作需要唯一排序规则,但无法确定。 有效