【Oracle】ORA-12899「値が大きすぎます」の原因と対策！文字数ではなく「バイト数」の罠を徹底解説

Read/Search Later

2021.08.022026.06.09

こんにちは！Oracle Databaseを使ったシステムの開発や運用保守、日々お疲れ様です。

システムにデータを登録（INSERT）したり、更新（UPDATE）したりした際、突然以下のようなエラーを吐いて処理が落ちた経験はありませんか？

Plaintext

ORA-12899: 列"スキーマ名"."テーブル名"."列名"の値が大きすぎます(実際: 11、最大: 10)

「エラーメッセージに書かれている通り、定義されたサイズ（最大値）を超えたデータを入れようとしただけ」ではあるのですが、実はこのエラー、「画面上やプログラム上は、指定された文字数にちゃんと収めているはずなのに発生する」という、初見殺しの罠（仕様）が隠されています。

今回は、ORA-12899が発生する根本的な原因と、知っておくべき文字コードの仕様、そして具体的な解決策について詳しく解説します！

1. ORA-12899が発生する根本原因：原因は「文字数」ではなく「バイト数」
1. ⚠️ 文字コードによる「1バイト」の壁
2. ORA-12899を解決する3つのアプローチ
まとめ
参考

1. ORA-12899が発生する根本原因：原因は「文字数」ではなく「バイト数」

例えば、VARCHAR2(10) というサイズ定義の列（カラム）があるとします。ここに「あいうえお（5文字）」という日本語を入力して登録しようとすると、エラーが発生することがあります。

「10文字まで入るカラムに5文字を入れようとしたのになぜ？」と思いますよね。

原因は、Oracleのデフォルト設定では VARCHAR2(10) の「10」が、文字数ではなく「10バイト」を意味しているからです。

⚠️ 文字コードによる「1バイト」の壁

日本語（全角文字）をデータとして扱う場合、データベースの文字コード設定（NLS_CHARACTERSET）によって、1文字あたりに消費する「バイト数」が異なります。

JA16SJIS（Shift-JIS環境）： 全角1文字＝ 2バイト
AL32UTF8（UTF-8環境）： 全角1文字＝ 3バイト 💡現在の主流

例えば、UTF-8環境のデータベースの場合、「あいうえお（5文字）」は 15バイト 処理されます。これを VARCHAR2(10バイト) の列に入れようとすると、制限の10バイトをオーバーしてしまうため、画面上は5文字しかなくても 「値が大きすぎます（実際: 15、最大: 10）」 と怒られてしまうのです。

2. ORA-12899を解決する3つのアプローチ

このエラーを解消するためには、システムの状況に合わせて以下のいずれかの対策を取る必要があります。

対策①：カラムの定義を「文字数セマンティクス（CHAR）」に変更する（推奨）

「全角・半角に関わらず、とにかく〇文字まで入るようにしたい！」という場合は、テーブルの列定義を「バイト」から「文字数」ベースに変更するのが一番スマートです。

型の後ろに CHAR と明記してテーブルを定義し直します。

SQL

-- 変更前（デフォルトはBYTE扱い）
ALTER TABLE テーブル名 MODIFY ( 列名 VARCHAR2(10) );

-- 変更後（10「文字」まで許容する設定に変更）
ALTER TABLE テーブル名 MODIFY ( 列名 VARCHAR2(10 CHAR) );

こうすることで、内部のバイト数が30バイトに膨らんだとしても、Oracleが「10文字以内だからOK」と自動で解釈してくれるようになり、文字コードを意識したカツカツの計算から解放されます。

対策②：カラムの許容バイト数を単純に拡張する

既存のシステムの都合上、文字数セマンティクス（CHAR）への変更が難しい場合は、単純に上限値を引き上げます。 UTF-8環境で「最大10文字」を入れたいのであれば、最低でも 10文字 × 3バイト＝ 30バイト 以上のサイズを確保します。

SQL

ALTER TABLE テーブル名 MODIFY ( 列名 VARCHAR2(30) );

対策③：プログラム（入力チェック）側で制限をかける

データベース側を変更できない場合は、フロントエンド（Web画面など）や、データを投入するバッチプログラム側で事前にバリデーション（入力チェック）を強化します。「文字数」でチェックするのではなく、「UTF-8（またはShift-JIS）に変換した際のバイト数」をプログラミング言語側で計算し、上限を超えている場合はエラーを返すように実装を修正します。