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)

값이 컬럼의 최대 길이보다 길어요.

실제 DB 검증Oracle AI Database 26ai Free 23.26.3.0.0에서 재현·해결 확인 · 2026-11-12

ORA-12899 메시지에 필요한 게 다 있어요. 컬럼("스키마"."테이블"."컬럼"), 넣으려던 값의 길이(실제), 컬럼 한도(최대값).

함정은 단위예요. VARCHAR2(10)은 기본이 10글자가 아니라 10바이트예요. AL32UTF8 DB에서 한글 한 글자는 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글자 이름이에요. 들어갈 것 같은데 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)만 나오고, 한 행도 바뀌지 않아요.

새 길이를 먼저 계산해 보면 안 들어가는 행이 전부 보여요. VARCHAR2(100)으로 늘린 뒤 두 행 모두 수정됐어요.

사전 준비
사전 준비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에서 한글은 한 글자 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

관련 에러