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

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

百科 / 错误代码 / Class 22 数据异常

22034 more_than_one_sql_json_item

ERROR 源码确认 参考 未实测

类别
Class 22 数据异常
严重等级
ERROR
条件名
more_than_one_sql_json_item
宏名称
ERRCODE_MORE_THAN_ONE_SQL_JSON_ITEM
启用版本
12
状态
活跃

版本覆盖

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

速览

操作要求单个 SQL/JSON 项却得到多个项。固定 JSON_QUERY/JSON_VALUE 路径报告必须是单项或单标量，并可能提示使用 WITH WRAPPER。

报文

无 wrapper 的基数守卫使用以下首要文本：

操作 首要文本和提示
无 wrapper 的 JSON_QUERY 列 JSON path expression for column "%s" must return single item when no wrapper is requested；HINT：Use the WITH WRAPPER clause to wrap SQL/JSON items into an array.
没有列名的 JSON_QUERY JSON path expression in JSON_QUERY must return single item when no wrapper is requested；HINT：Use the WITH WRAPPER clause to wrap SQL/JSON items into an array.
JSON_VALUE 返回多个项 JSON path expression in JSON_VALUE must return single scalar item

报文模板

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

主消息 JSON path expression for column "%s" must return single item when no wrapper is requested
HINT Use the WITH WRAPPER clause to wrap SQL/JSON items into an array.

来源：src/backend/utils/adt/jsonpath_exec.c @ REL_18_6

主消息 JSON path expression in JSON_QUERY must return single item when no wrapper is requested
HINT Use the WITH WRAPPER clause to wrap SQL/JSON items into an array.

来源：src/backend/utils/adt/jsonpath_exec.c @ REL_18_6

主消息 JSON path expression in JSON_VALUE must return single scalar item

来源：src/backend/utils/adt/jsonpath_exec.c @ REL_18_6

含义

固定的 JSON_QUERY 路径会收集完整 SQL/JSON 结果列表，并在应用 wrapper 模式前统计数量。没有 wrapper 时返回多个项会报告 22034；无条件或条件 WITH WRAPPER 会按模式把序列变成数组。JSON_VALUE 返回多个项时也使用本码，因为它要求单个标量。恰好一个非标量项属于独立的 2203F，零项则设置 empty 标志并交给 ON EMPTY 处理。lax 的自动展开可能改变结果基数；silent 或非 ERROR 的 ON ERROR 行为可能在基数守卫之前抑制求值错误。

诊断

记录操作类型（JSON_QUERY 或 JSON_VALUE）、wrapper 子句、列名以及 path 产生的项数。JSON_QUERY 只有在确实需要数组结果时才使用 WITH WRAPPER；JSON_VALUE 应将 path 缩减为单个标量。区分多个项（22034）、单个非标量项（2203F）和由 ON EMPTY/22035 处理的无项结果。检查 strict/lax 和 silent 设置，因为它们会影响守卫看到的结果序列。

处理

修改 path 或过滤条件，使其返回所需的单个项；如果消费方需要数组，则加入文档规定的 wrapper。对 JSON_VALUE 还要确保该项是标量。如果操作使用 ON ERROR 行为，应使回退值符合预期基数，不要把 NULL 误当成 path 返回了单个项。如果 ERROR 发生在显式事务中，应先 ROLLBACK 或回滚到既有保存点再重试；自动提交可重试修正后的表达式。

版本

锁定目录从 12.0 起记录该条件；本页固定 SQL/JSON 基数源码路径为 PostgreSQL 18.6。未声称本页有自然运行观察。

来源

证据

断言

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

  • 22034 is more_than_one_sql_json_item in SQLSTATE Class 22.

    核实方式Read fixed definition.

    来源src/backend/utils/errcodes.txt

  • The fixed JSON_QUERY path collects the complete SQL/JSON result list, uses the wrapper mode to permit multiple items, and emits 22034 only when more than one item remains without a wrapper; JSON_VALUE uses the same code for more than one item, while a single non-scalar is the separate 2203F condition.

    核实方式Read JsonPathQuery and JsonPathValue cardinality, wrapper, and scalar guards.

    不覆盖Source confirmation is not a natural runtime observation.

    来源src/backend/utils/adt/jsonpath_exec.c · src/backend/utils/adt/jsonpath_exec.c

  • The locked catalogue records 22034 from 12.0 without proving exact implementation introduction.

    核实方式Use catalogue boundary.

    来源src/backend/utils/errcodes.txt

同类错误代码

Class 22 数据异常 下的其他成员。