// PostgreSQL 错误参考

PostgreSQL 22023:无效的参数值

设置或函数参数的值超出了其可接受的范围:未知的时区、内存设置中的错误单位、generate_series 中的零步长。

SQLSTATE
22023
名称
invalid_parameter_value
类别
数据异常
错误信息
invalid value for parameter "TimeZone": "Mars/Olympus"

它的意思

22023 (invalid_parameter_value)表示值的类型正确但不在允许的取值范围内。对于配置参数,消息是 invalid value for parameter "name": "value",通常会附上一条提示,列出有效的单位或取值。许多内置函数对错误参数共用同一套报错代码,例如 step size cannot equal zero 来自 generate_series.

仔细阅读消息和提示:它们会指明参数及通常允许的值。

常见原因

  • PostgreSQL 不认识的时区名称(有效名称在 pg_timezone_names).
  • 内存或时间设置的单位写错了,例如 work_mem = '64mb' 代替 '64MB' (单位区分大小写)。
  • 超出允许范围或集合的函数参数,例如零步长或未知选项关键字。

如何修复它

  1. 检查设置的有效值。

    SELECT name, unit, vartype, min_val, max_val, enumvals
    FROM pg_settings WHERE name = 'work_mem';
  2. 从 PostgreSQL 已知的列表中选择一个时区。

    SELECT name FROM pg_timezone_names WHERE name ILIKE '%new_york%';
    SET TimeZone = 'America/New_York';
  3. 单位按 PostgreSQL 的写法: kB, MB, GB, TB 用于内存和 us, ms, s, min, h, d 用于时间。

    SET work_mem = '64MB';
    SET statement_timeout = '30s';

安全地复现它

SET TimeZone = 'Mars/Olympus';  -- ERROR: invalid value for parameter "TimeZone": "Mars/Olympus"

相关错误

更多数据异常错误

代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。