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값이 컬럼보다 그냥 긺
CITY는 VARCHAR2(10)인데 San Francisco는 13글자라 (actual: 13, maximum: 10)이 나와요.
ALTER TABLE customers MODIFY city VARCHAR2(50)으로 컬럼을 늘리자 같은 INSERT가 성공했어요.
사전 준비
CREATE TABLE customers (customer_id NUMBER PRIMARY KEY, city VARCHAR2(10));Table created.INSERT INTO customers VALUES (1, 'San Francisco');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/ALTER TABLE customers MODIFY city VARCHAR2(50);Table altered.길이를 늘리는 건 기존 데이터에 영향이 없어요. 컬럼이 작은 게 아니라 값이 잘못된 거라면 입력 쪽을 고치세요.
INSERT INTO customers VALUES (1, 'San Francisco');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로 만든 건 클라이언트 문자셋이 테스트에 영향을 주지 않게 하려는 거예요.
사전 준비
CREATE TABLE members (member_id NUMBER PRIMARY KEY, name VARCHAR2(10));Table created.INSERT INTO members VALUES (1, UNISTR('\AE40\C218\D55C\AE38'));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/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;VALUE
----------------------------------------------------------------
AL32UTF8
1 row selected.
CHARS BYTES
---------- ----------
4 12
1 row selected.ALTER TABLE members MODIFY name VARCHAR2(10 CHAR);Table altered.INSERT INTO members VALUES (1, UNISTR('\AE40\C218\D55C\AE38'));1 row created.3UPDATE로 기존 값 뒤에 문자열을 덧붙임
UPDATE ... SET memo = memo || ' [CANCELLED]'는 모든 메모를 길게 만들어요. 1번은 21글자, 2번은 31글자가 되어 둘 다 VARCHAR2(20)을 넘어요. 에러에는 처음 실패한 행(actual: 21)만 나오고, 한 행도 바뀌지 않아요.
새 길이를 먼저 계산해 보면 안 들어가는 행이 전부 보여요. VARCHAR2(100)으로 늘린 뒤 두 행 모두 수정됐어요.
사전 준비
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;Table created.
1 row created.
1 row created.
Commit complete.UPDATE orders SET memo = memo || ' [CANCELLED]';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/SELECT order_id, LENGTH(memo || ' [CANCELLED]') AS new_len FROM orders WHERE LENGTH(memo || ' [CANCELLED]') > 20; ORDER_ID NEW_LEN
---------- ----------
1 21
2 31
2 rows selected.ALTER TABLE orders MODIFY memo VARCHAR2(100);Table altered.UPDATE orders SET memo = memo || ' [CANCELLED]';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