ORA-12899: 列の値が大きすぎます(実際: n、最大: m)

ORA-12899: 列"LAB_A"."CUSTOMERS"."CITY"の値が大きすぎます(実際: 13、最大: 10)
ORA-12899: value too large for column "LAB_A"."CUSTOMERS"."CITY" (actual: 13, maximum: 10)

値が列の最大長より長くなっています。

実機検証済みOracle AI Database 26ai Free 23.26.3.0.0 で再現・解決を確認 · 2026-11-12

ORA-12899のメッセージには必要な情報がそろっています。列("スキーマ"."表"."列")、入れようとした値の長さ(実際)、列の上限(最大)です。

落とし穴は単位です。VARCHAR2(10)はデフォルトで10文字ではなく10バイトです。AL32UTF8のDBでは日本語や韓国語は1文字3バイトなので、見た目の文字数より実際が大きくなります。

原因と対処法

  1. 値が列より単純に長い
  2. マルチバイト文字: 列の長さが文字数ではなくバイト数
  3. UPDATEで既存の値に文字列を追加している

1値が列より単純に長い

CITYはVARCHAR2(10)で、San Franciscoは13文字なので(actual: 13, maximum: 10)になります。

ALTER TABLE customers MODIFY city VARCHAR2(50)で列を広げると、同じINSERTが成功しました。

事前準備
事前準備lab_a で実行
CREATE TABLE customers (customer_id NUMBER PRIMARY KEY, city VARCHAR2(10));
OUTPUT
Table created.
再現lab_a で実行
INSERT INTO customers VALUES (1, 'San Francisco');
OUTPUT
INSERT INTO customers VALUES (1, 'San Francisco')
                                 *
ERROR at line 1:
ORA-12899: value too large for column "LAB_A"."CUSTOMERS"."CITY" (actual: 13, maximum: 10)
Help: https://docs.oracle.com/error-help/db/ora-12899/
対処lab_a で実行
ALTER TABLE customers MODIFY city VARCHAR2(50);
OUTPUT
Table altered.

長さを広げても既存データには影響しません。列が小さいのではなく値が間違っている場合は、入力側を直してください。

対処後の再実行lab_a で実行
INSERT INTO customers VALUES (1, 'San Francisco');
OUTPUT
1 row created.

2マルチバイト文字: 列の長さが文字数ではなくバイト数

NAMEはVARCHAR2(10)で、入れる値は4文字の韓国語の名前です(日本語でも同じく1文字3バイトです)。入りそうに見えますがactual: 12になります。DBの文字セットはAL32UTF8で、LENGTH/LENGTHBで見ると4文字・12バイトです。

VARCHAR2(10)がデフォルトのBYTEで作られているためです。VARCHAR2(10 CHAR)に変えると10文字まで入り、INSERTが成功しました。

SQLで名前をUNISTRで作っているのは、クライアントの文字セットがテストに影響しないようにするためです。

事前準備
事前準備lab_a で実行
CREATE TABLE members (member_id NUMBER PRIMARY KEY, name VARCHAR2(10));
OUTPUT
Table created.
再現lab_a で実行
INSERT INTO members VALUES (1, UNISTR('\AE40\C218\D55C\AE38'));
OUTPUT
INSERT INTO members VALUES (1, UNISTR('\AE40\C218\D55C\AE38'))
                               *
ERROR at line 1:
ORA-12899: value too large for column "LAB_A"."MEMBERS"."NAME" (actual: 12, maximum: 10)
Help: https://docs.oracle.com/error-help/db/ora-12899/
確認lab_a で実行
SELECT value FROM nls_database_parameters WHERE parameter = 'NLS_CHARACTERSET';
SELECT LENGTH(TO_CHAR(UNISTR('\AE40\C218\D55C\AE38'))) AS chars, LENGTHB(TO_CHAR(UNISTR('\AE40\C218\D55C\AE38'))) AS bytes FROM dual;
OUTPUT
VALUE
----------------------------------------------------------------
AL32UTF8

1 row selected.


     CHARS      BYTES
---------- ----------
         4         12

1 row selected.
対処lab_a で実行
ALTER TABLE members MODIFY name VARCHAR2(10 CHAR);
OUTPUT
Table altered.
対処後の再実行lab_a で実行
INSERT INTO members VALUES (1, UNISTR('\AE40\C218\D55C\AE38'));
OUTPUT
1 row created.

3UPDATEで既存の値に文字列を追加している

UPDATE ... SET memo = memo || ' [CANCELLED]'はすべてのメモを長くします。1行目は21文字、2行目は31文字になり、どちらもVARCHAR2(20)を超えます。エラーには最初に失敗した行(actual: 21)だけが出て、1行も更新されません。

新しい長さを先に計算すると、入らない行がすべて分かります。VARCHAR2(100)に広げた後、2行とも更新されました。

事前準備
事前準備lab_a で実行
CREATE TABLE orders (order_id NUMBER PRIMARY KEY, memo VARCHAR2(20));
INSERT INTO orders VALUES (1, 'Gift wrap');
INSERT INTO orders VALUES (2, 'Leave at front door');
COMMIT;
OUTPUT
Table created.


1 row created.


1 row created.


Commit complete.
再現lab_a で実行
UPDATE orders SET memo = memo || ' [CANCELLED]';
OUTPUT
UPDATE orders SET memo = memo || ' [CANCELLED]'
                               *
ERROR at line 1:
ORA-12899: value too large for column "LAB_A"."ORDERS"."MEMO" (actual: 21, maximum: 20)
Help: https://docs.oracle.com/error-help/db/ora-12899/
確認lab_a で実行
SELECT order_id, LENGTH(memo || ' [CANCELLED]') AS new_len FROM orders WHERE LENGTH(memo || ' [CANCELLED]') > 20;
OUTPUT
  ORDER_ID    NEW_LEN
---------- ----------
         1         21
         2         31

2 rows selected.
対処lab_a で実行
ALTER TABLE orders MODIFY memo VARCHAR2(100);
OUTPUT
Table altered.
対処後の再実行lab_a で実行
UPDATE orders SET memo = memo || ' [CANCELLED]';
OUTPUT
2 rows updated.

よくある質問

文字数は列のサイズより少ないのに、なぜORA-12899が出ますか?

列がバイト単位だからです。AL32UTF8では日本語は1文字3バイトです。値のLENGTHとLENGTHBを比べ、VARCHAR2(n CHAR)を検討してください。

ORA-12899の原因の列はどう分かりますか?

メッセージに"スキーマ"."表"."列"の形で出ます。実際は入れようとした値の長さ、最大は列の上限です。

列がBYTEかCHARかはどう確認しますか?

USER_TAB_COLUMNSのCHAR_USEDを見てください。Bならバイト、Cなら文字単位です。

検証方法

シナリオごとに新しいDBユーザーを作成して開始します。スクリプトが事前準備 → エラー再現(エラーコードの一致を確認)→ 対処 → 元の文の再実行の順に実行し、表示している出力はDBが実際に返した結果をスクリプトがそのまま保存したものです。

lab_a・lab_b はテスト用の一般ユーザー、system は DBA アカウントです。 Oracle AI Database 26ai Free Release 23.26.3.0.0 - Develop, Learn, and Run for Free

関連エラー