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

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

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

22000 data_exception

ERROR 源码确认 参考 未实测

类别
Class 22 数据异常
严重等级
ERROR
条件名
data_exception
宏名称
ERRCODE_DATA_EXCEPTION
启用版本
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

速览

固定 array_append 路径要求数组参数为空或一维，否则报告维度错误；其他 Data Exception 路径有各自的消息。

含义

固定 array_append 路径要求数组参数为空或一维，否则报告维度错误；其他 Data Exception 路径有各自的消息。

报文

已确认的 guard 以 ERROR 严重性报告 primary：argument must be empty or one-dimensional array。该源码路径没有独立的 DETAIL 或 HINT。本页只有源码证据，没有自然运行观察。

报文模板

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

主消息 argument must be empty or one-dimensional array

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

诊断

先看完整消息、array_append 调用和参数类型。已确认的路径拒绝既非空又非一维的数组参数；其他 Data Exception 路径需按各自消息定位。

处置

修正数组形状或改用接受目标维度的函数契约，先校验参数再执行。这是 ERROR：显式事务中要回滚整个事务，或回滚到调用前建立的保存点后再继续。不要把所有 Data Exception 当成同一种修复；本页没有运行案例。

版本

锁定目录从 7.4 记录该条件，并在列出的正式快照及 19beta3 中出现；固定源码覆盖为 PostgreSQL 18.6。

来源

证据

断言

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

  • 22000 is data_exception in SQLSTATE Class 22.

    核实方式Read fixed definition.

    来源src/backend/utils/errcodes.txt

  • array_append accepts an empty or one-dimensional array; a multi-dimensional argument emits 22000 with the dimensionality message.

    核实方式Read the complete array_userfuncs.c branch.

    不覆盖This confirms one core array path, not every Data Exception caller.

    来源src/backend/utils/adt/array_userfuncs.c

  • The locked catalogue records 22000 from 7.4 without proving an exact implementation introduction date.

    核实方式Use catalogue boundary.

    来源src/backend/utils/errcodes.txt

同类错误代码

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