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

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

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

2201F invalid_argument_for_power_function

ERROR 源码确认 参考 未实测

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

版本覆盖

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

速览

幂函数会拒绝实数结果未定义的操作数。固定 numeric 路径报告 zero raised to a negative power is undefined 或 a negative number raised to a non-integer power yields a complex result。

含义

2201F 覆盖两个不同的幂运算守卫：零底数配负指数，以及负底数配非整数指数。普通有限 numeric 路径和特殊值路径都存在相应检查。按 POSIX 规则，numeric 的 NaN 可能返回 NaN 或 1，若干无穷组合也有定义结果；负底数配整数指数并不自动触发本码。

报文模板

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

主消息 zero raised to a negative power is undefined

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

主消息 a negative number raised to a non-integer power yields a complex result

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

诊断

检查解析后的底数、指数类型和首要报文。非整数小数指数与负整数指数不是同一种情况，改小数位数或无关 cast 不能修复定义域。特殊值要单独判断，不要把所有 NaN 或无穷值都当成无效幂运算。

处理

选择具有预期实数结果的底数/指数，或明确改变业务规则。如果 ERROR 发生在显式事务中，应先 ROLLBACK 或回滚到既有保存点再重试；自动提交客户端可直接重试修正后的操作。

版本

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

来源

证据

断言

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

同类错误代码

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