// PostgreSQL 错误参考
PostgreSQL 22003:数值超出范围
一个数字不适合其类型:整数溢出、numeric(p,s) 值过大,或 id 列达到 int4 上限。
- SQLSTATE
22003- 名称
numeric_value_out_of_range- 类别
- 数据异常
它的意思
每种数值类型都有其取值范围: smallint 最多 32767, integer 最多 32,767, bigint 最多约 9.2 × 10^18,且 numeric(p, s) 最多 p 位数字,小数点后有 s 位。值或计算结果超出范围会导致 22003 错误。该消息会指明类型: integer out of range, bigint out of range, smallint out of range,或 numeric field overflow 用于 numeric(p, s).
两个整数的算术运算在整数中进行,因此 count * price_in_cents 可能溢出,即使最终答案存储在 bigint 列。
常见原因
- A
serial(整数) 主键达到了 2147483647,于是nextval生成了列无法存储的值。 - 对整数做乘法或求和时,结果在类型转换之前就超出了整数范围。
- 值的位数超过了
numeric(p, s)允许,例如 1000.00 出现在numeric(5,2)列。 - 将大型文本或浮点值强制转换为
integer或者smallint.
如何修复它
-
加宽该列;对于快要用尽的整型 id,则换成
bigint(这会重写表,因此需提前计划)。ALTER TABLE events ALTER COLUMN id TYPE bigint; ALTER SEQUENCE events_id_seq AS bigint;
-
在算术操作前先强制转换为更宽的类型,而不是操作后。
SELECT qty::bigint * unit_price_cents FROM order_lines;
-
增加精度
numeric(p, s)列。ALTER TABLE invoices ALTER COLUMN total TYPE numeric(12, 2);
-
检查序列距离其上限还有多远。
SELECT last_value, max_value FROM pg_sequences WHERE sequencename = 'events_id_seq';
安全地复现它
SELECT 2147483647 + 1; -- ERROR: integer out of range SELECT 1000::numeric(5, 2); -- ERROR: numeric field overflow
相关错误
22001值对于该类型来说过长22P02类型的输入语法无效22012除以零8115SQL Server:转换时发生算术溢出错误1264MySQL:列的值超出范围ORA-01438Oracle:值大于指定精度
更多数据异常错误
代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.
// 错误更少,修复更快
在 SQLly 中使用 PostgreSQL
适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。