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

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

百科 / 错误代码 / Class 42 语法错误或访问规则冲突

42P09 ambiguous_alias

表别名不明确

ERROR 源码确认 详解 未实测

类别
Class 42 语法错误或访问规则冲突
严重等级
ERROR
条件名
ambiguous_alias
宏名称
ERRCODE_AMBIGUOUS_ALIAS
启用版本
7.4
状态
活跃

版本覆盖

  1. 18
  2. 17
  3. 16
  4. 15
  5. 14
  1. 13
  2. 12
  3. 11
  4. 10
  1. 19 beta
  2. 20 dev

速览

42P09（ambiguous_alias）是解析阶段的 ERROR：一个可见表引用对应多个关系命名空间项。它发生在执行前，并有文本别名和关系 OID 两条路径。

含义

文本引用由 scanNameSpaceForRefname 比较可见命名空间别名，发现第二个可见匹配时报告 table reference "%s" is ambiguous。仅列项和非活动 LATERAL 作用域中的 lateral-only 项会被排除。scanNameSpaceForRelid 另一条路径按 OID 匹配无别名关系 RTE，同一关系出现多次时报告 table reference %u is ambiguous。两条路径都带解析位置，且不同于列歧义。

诊断

检查 FROM/JOIN 树、别名、子查询/CTE 可见性和 LATERAL 作用域。若主消息带引号名称，查找重复的可见别名；若带 OID，查找重复的无别名同一关系 RTE。还要检查连接别名是否隐藏内部命名空间，或 LATERAL 子查询是否同时暴露两个别名。search_path 可能影响前面的关系查找，但不能作为已存在重复解析项的通用修复。

处理

给可见关系设置有意义且不同的别名，并通过别名限定引用，或从查询构造器删除多余关系。保留有意的 LATERAL 作用域，修改后核对连接基数。不要把 42P09 当作 42P01（关系不存在）或 42702（列歧义），也不要反复提交相同文本。解析 ERROR 若发生在显式事务中，应回滚到保存点或回滚事务再继续。

消息变体

选定变体均为 ERROR：

解析路径 主消息
重复的可见别名/名称 table reference "%s" is ambiguous
重复的无别名关系 OID table reference %u is ambiguous

两者都附带解析位置；%s 和 %u 是源码中的动态字段。

报文模板

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

主消息 table reference "%s" is ambiguous

来源：src/backend/parser/parse_relation.c（lines 224-228） @ REL_18_6

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

主消息 table reference %u is ambiguous

来源：src/backend/parser/parse_relation.c（lines 271-275） @ REL_18_6

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

版本

目录范围从 7.4 到 18.6、19beta3，不是精确的功能引入判断。选定的是 18.6 固定文本别名和内部 OID 源码路径，未运行数据库。

来源

证据

断言

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

  • 42P09 is the ambiguous_alias condition in Class 42.

    核实方式Read fixed REL_18_6 errcodes.txt and locked facts.

    不覆盖Identity does not enumerate all source branches or client failures.

    来源src/backend/utils/errcodes.txt（line 389）

  • scanNameSpaceForRefname compares visible aliases and reports `table reference "%s" is ambiguous` on a duplicate visible alias; scanNameSpaceForRelid reports `table reference %u is ambiguous` when an unaliased relation RTE with the same OID appears more than once. Lateral-only and column-only visibility guards are applied, and both paths are separate from column ambiguity.

    核实方式Read complete resolved REL_18_6 report groups and message roles.

    不覆盖Representative confirmed core paths only; not exhaustive historical or extension coverage.

    来源src/backend/parser/parse_relation.c（lines 224-228） · src/backend/parser/parse_relation.c（lines 271-275）

  • From 7.4 through 18.6 and 19beta3; this catalogue range is not a precise introduction claim. The selected named-alias and internal-OID branches are fixed 18.6 source paths and runtime was not run.

    核实方式Read locked catalogue facts and definition snapshots.

    不覆盖First observed release is a lower bound, not precise behavioral introduction.

    来源src/backend/utils/errcodes.txt（line 389）

同类错误代码

Class 42 语法错误或访问规则冲突 下的其他成员。