// PostgreSQL 错误参考
PostgreSQL 22001:值超出该类型的长度限制
字符串长度超过了列的 varchar(n) 或 char(n) 限制。PostgreSQL 会拒绝它,而不是默默截断。
- SQLSTATE
22001- 名称
string_data_right_truncation- 类别
- 数据异常
它的意思
A varchar(n) 或者 char(n) 列最多可容纳 n 个字符。插入或更新更长的值会导致 22001 错误(string_data_right_truncation)。只有显式转换类型时,PostgreSQL 才会默默截断,比如 'abcdef'::varchar(3),这也是 SQL 标准的要求。
该消息指出了类型,却没有指出列,所以当有多个受长度限制的列时,你需要排查到底是哪个值太长。
常见原因
- 用户输入或导入的数据超过了列定义的长度。
- 一个多列
INSERT其中值的顺序与列列表不同,将一个长值放入一个短列中。 - 从其他数据库迁移而来且带有严格限制的模式。
如何修复它
-
比较值的长度与限制,找出溢出的列。
SELECT column_name, character_maximum_length FROM information_schema.columns WHERE table_name = 'customers' AND character_maximum_length IS NOT NULL;
-
加宽该列,或者改用
text,它没有长度限制,性能与varchar.ALTER TABLE customers ALTER COLUMN name TYPE varchar(200); -- or ALTER TABLE customers ALTER COLUMN name TYPE text;
-
如果可以接受截断,请显式执行截断。
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 使用相同的存储。长度限制是对数据的约束,而不是性能特性。
相关错误
22003数值超出范围22P02类型的输入语法无效8152SQL Server:字符串或二进制数据被截断2628SQL Server:在表和列中被截断1406MySQL:列的数据过长ORA-12899Oracle:列的值太大
更多数据异常错误
代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.
// 错误更少,修复更快
在 SQLly 中使用 PostgreSQL
适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。