// 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)。1 つの VARCHAR2(50) 列はデフォルトで50バイトです(NLS_LENGTH_SEMANTICS = BYTE)、アクセント付き文字や非ラテン文字を含むテキストは AL32UTF8 では 1 文字あたり 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 の前に意図的に切り詰めます。

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

関連エラー

その他のデータ値と変換のエラー

コードとメッセージのテキストは、 Oracle Database エラーヘルプ。全容は次で参照 Oracleエラーリスト または すべてのデータベースエラーを検索.

// エラーが減り、修正も速く

SQLly で Oracle を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、Oracle をはじめ、お使いの他のデータベースにも対応します。