// Oracle 错误参考

ORA-12899:列的值过大

某个值比列允许的长度要长。消息会注明列的名称,并给出实际长度和最大长度,通常以字节而非字符为单位。

错误代码
ORA-12899
类别
数据值和转换
错误信息
value too large for column string (actual: string, maximum: string)

它的意思

ORA-12899 表示字符串装不进它的列,例如 ORA-12899: value too large for column "SALES"."CUSTOMERS"."NAME" (actual: 61, maximum: 50)。一个 VARCHAR2(50) 列默认是 50 字节(NLS_LENGTH_SEMANTICS = BYTE),因此带重音符号或非拉丁字符的文本,其每个字符在 AL32UTF8 中要占 2 到 4 个字节,可能会撑爆一个看起来足够长的列。

常见原因

  • 数据长度超过了列定义。
  • 按字节大小定义的列中的多字节字符。
  • 迁移到 Unicode 数据库字符集,导致某些字符串的字节数变长。

如何修复它

  1. 找出将写入该列的最长值,并与列定义进行比较。

    SELECT column_name, data_type, data_length, char_length, char_used
    FROM all_tab_columns WHERE table_name = 'CUSTOMERS' AND column_name = 'NAME';
  2. 加宽该列;如果存放的是多语言文本,就按字符数设定长度。

    ALTER TABLE customers MODIFY (name VARCHAR2(200 CHAR));
  3. 或者,如果能接受丢失尾部,就在插入前有意截断。

    INSERT INTO customers (name) VALUES (SUBSTR(:name, 1, 50));

相关错误

更多数据值和转换错误

代码和消息文本来自 Oracle 数据库错误帮助。浏览完整的 Oracle 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 Oracle

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