// PostgreSQL 错误参考

PostgreSQL 22001:值超出该类型的长度限制

字符串长度超过了列的 varchar(n) 或 char(n) 限制。PostgreSQL 会拒绝它,而不是默默截断。

SQLSTATE
22001
名称
string_data_right_truncation
类别
数据异常
错误信息
value too long for type character varying(20)

它的意思

A varchar(n) 或者 char(n) 列最多可容纳 n 个字符。插入或更新更长的值会导致 22001 错误(string_data_right_truncation)。只有显式转换类型时,PostgreSQL 才会默默截断,比如 'abcdef'::varchar(3),这也是 SQL 标准的要求。

该消息指出了类型,却没有指出列,所以当有多个受长度限制的列时,你需要排查到底是哪个值太长。

常见原因

  • 用户输入或导入的数据超过了列定义的长度。
  • 一个多列 INSERT 其中值的顺序与列列表不同,将一个长值放入一个短列中。
  • 从其他数据库迁移而来且带有严格限制的模式。

如何修复它

  1. 比较值的长度与限制,找出溢出的列。

    SELECT column_name, character_maximum_length
    FROM information_schema.columns
    WHERE table_name = 'customers' AND character_maximum_length IS NOT NULL;
  2. 加宽该列,或者改用 text,它没有长度限制,性能与 varchar.

    ALTER TABLE customers ALTER COLUMN name TYPE varchar(200);
    -- or
    ALTER TABLE customers ALTER COLUMN name TYPE text;
  3. 如果可以接受截断,请显式执行截断。

    INSERT INTO customers (name) VALUES (left('a very long name ...', 20));

安全地复现它

SELECT CAST('abc' AS varchar(2)) AS silently_truncated;
CREATE TEMP TABLE t (code varchar(2));
INSERT INTO t VALUES ('abc');  -- ERROR: value too long for type character varying(2)

问题

在 PostgreSQL 中,text 比 varchar 慢吗?

不。text 和 varchar 使用相同的存储。长度限制是对数据的约束,而不是性能特性。

相关错误

更多数据异常错误

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

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

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