ORA-06502: PL/SQL: 값 또는 변환 오류
ORA-06502: PL/SQL: 값 또는 변환 오류 : 문자열 버퍼가 너무 작습니다ORA-06502: PL/SQL: value or conversion error: character string buffer too smallPL/SQL 변수에 들어갈 수 없는 값을 넣었어요.
실제 DB 검증Oracle AI Database 26ai Free 23.26.3.0.0에서 재현·해결 확인 · 2026-11-14
ORA-06502는 PL/SQL 변수에 맞지 않는 값을 넣을 때 나요. VARCHAR2 크기보다 긴 문자열, 숫자가 아닌 문자, NUMBER(p) 자릿수를 넘는 숫자가 대표적이에요. 예전 버전은 "수치 또는 값 오류", 23ai는 "값 또는 변환 오류"라고 나와요.
콜론 뒤 문구를 보면 어느 경우인지 알 수 있어요. 아래 ORA-06512: at line N은 실패한 대입문이나 SELECT INTO 줄을 가리켜요.
원인별 해결 방법
1VARCHAR2 변수가 컬럼 값보다 짧음
name을 v_name VARCHAR2(10)에 읽어요. 첫 고객 Kim은 잘 출력됐어요. 두 번째 Northwind Trading Company는 25자라서 "문자열 버퍼가 너무 작습니다"로 멈췄고, 5번째 줄 SELECT INTO를 가리켰어요.
변수를 customer.name%TYPE으로 선언하면 항상 컬럼 크기를 따라가요. 바꾼 뒤 두 행 모두 출력됐어요.
사전 준비
CREATE TABLE customer (cust_id NUMBER PRIMARY KEY, name VARCHAR2(50));
INSERT INTO customer VALUES (1, 'Kim');
INSERT INTO customer VALUES (2, 'Northwind Trading Company');
COMMIT;Table created.
1 row created.
1 row created.
Commit complete.SET SERVEROUTPUT ON
DECLARE
v_name VARCHAR2(10);
BEGIN
FOR r IN (SELECT cust_id FROM customer ORDER BY cust_id) LOOP
SELECT name INTO v_name FROM customer WHERE cust_id = r.cust_id;
DBMS_OUTPUT.PUT_LINE(r.cust_id || ': ' || v_name);
END LOOP;
END;
/1: Kim
DECLARE
*
ERROR at line 1:
ORA-06502: PL/SQL: value or conversion error: character string buffer too small
ORA-06512: at line 5
ORA-06512: at line 5
Help: https://docs.oracle.com/error-help/db/ora-06502/SELECT cust_id, LENGTH(name) AS len FROM customer ORDER BY cust_id; CUST_ID LEN
---------- ----------
1 3
2 25
2 rows selected.LENGTH(name)은 3과 25였어요. 테스트에선 잘 돌다가 긴 값이 처음 들어오는 날 나는 경우가 많아요.
SET SERVEROUTPUT ON
DECLARE
v_name customer.name%TYPE;
BEGIN
FOR r IN (SELECT cust_id FROM customer ORDER BY cust_id) LOOP
SELECT name INTO v_name FROM customer WHERE cust_id = r.cust_id;
DBMS_OUTPUT.PUT_LINE(r.cust_id || ': ' || v_name);
END LOOP;
END;
/1: Kim
2: Northwind Trading Company
PL/SQL procedure successfully completed.2'1,200' 같은 문자를 NUMBER 변수에 넣음
업로드한 수량이 문자로 저장돼 있고 이를 v_qty NUMBER에 넣어요. 2번 줄이 천 단위 쉼표가 붙은 '1,200'이라서 자동 변환이 실패했어요. "문자를 숫자로 변환하는데 오류"가 6번째 줄 v_qty := r.qty_text;에서 났어요.
VALIDATE_CONVERSION(qty_text AS NUMBER) = 0으로 변환 안 되는 행을 찾으면 2번 줄 하나만 나와요. 형식을 지정한 TO_NUMBER(r.qty_text, '999G999')는 쉼표를 받아들였고 total=1217이 출력됐어요.
사전 준비
CREATE TABLE upload_line (line_no NUMBER, qty_text VARCHAR2(20));
INSERT INTO upload_line VALUES (1, '10');
INSERT INTO upload_line VALUES (2, '1,200');
INSERT INTO upload_line VALUES (3, '7');
COMMIT;Table created.
1 row created.
1 row created.
1 row created.
Commit complete.SET SERVEROUTPUT ON
DECLARE
v_qty NUMBER;
v_total NUMBER := 0;
BEGIN
FOR r IN (SELECT line_no, qty_text FROM upload_line ORDER BY line_no) LOOP
v_qty := r.qty_text;
v_total := v_total + v_qty;
END LOOP;
DBMS_OUTPUT.PUT_LINE('total=' || v_total);
END;
/DECLARE
*
ERROR at line 1:
ORA-06502: PL/SQL: value or conversion error: character to number conversion error
ORA-06512: at line 6
ORA-06512: at line 6
Help: https://docs.oracle.com/error-help/db/ora-06502/SELECT line_no, qty_text FROM upload_line
WHERE VALIDATE_CONVERSION(qty_text AS NUMBER) = 0; LINE_NO QTY_TEXT
---------- --------------------
2 1,200
1 row selected.G는 세션 NLS 설정의 천 단위 구분자예요. 데이터의 구분자가 다르면 먼저 VALIDATE_CONVERSION으로 행을 확인하세요.
SET SERVEROUTPUT ON
DECLARE
v_qty NUMBER;
v_total NUMBER := 0;
BEGIN
FOR r IN (SELECT line_no, qty_text FROM upload_line ORDER BY line_no) LOOP
v_qty := TO_NUMBER(r.qty_text, '999G999');
v_total := v_total + v_qty;
END LOOP;
DBMS_OUTPUT.PUT_LINE('total=' || v_total);
END;
/total=1217
PL/SQL procedure successfully completed.3NUMBER(p) 변수가 결과보다 작음
v_sum NUMBER(3)은 999까지만 담을 수 있는데 SUM(amount)가 1270이었어요. 4번째 줄 SELECT INTO에서 "숫자 정도가 너무 큽니다"가 났어요.
변수를 orders.amount%TYPE(여기서는 NUMBER(10,2))으로 선언하니 sum=1270이 출력됐어요.
사전 준비
CREATE TABLE orders (order_id NUMBER PRIMARY KEY, amount NUMBER(10,2));
INSERT INTO orders VALUES (1, 300);
INSERT INTO orders VALUES (2, 450);
INSERT INTO orders VALUES (3, 520);
COMMIT;Table created.
1 row created.
1 row created.
1 row created.
Commit complete.SET SERVEROUTPUT ON
DECLARE
v_sum NUMBER(3);
BEGIN
SELECT SUM(amount) INTO v_sum FROM orders;
DBMS_OUTPUT.PUT_LINE('sum=' || v_sum);
END;
/DECLARE
*
ERROR at line 1:
ORA-06502: PL/SQL: value or conversion error: number precision too large
ORA-06512: at line 4
Help: https://docs.oracle.com/error-help/db/ora-06502/SELECT SUM(amount) AS total FROM orders; TOTAL
----------
1270
1 row selected.합계는 시간이 지나면 커져요. 합계용 변수는 지금 보이는 값이 아니라 컬럼 타입에 맞추세요.
SET SERVEROUTPUT ON
DECLARE
v_sum orders.amount%TYPE;
BEGIN
SELECT SUM(amount) INTO v_sum FROM orders;
DBMS_OUTPUT.PUT_LINE('sum=' || v_sum);
END;
/sum=1270
PL/SQL procedure successfully completed.자주 묻는 질문
ORA-06502 문자열 버퍼가 너무 작습니다 해결 방법은?
값이 VARCHAR2 변수보다 길어요. 이 실습에서는 25자 이름을 VARCHAR2(10)에 넣었어요. 변수를 테이블.컬럼%TYPE으로 선언하세요.
"수치 또는 값 오류"와 "값 또는 변환 오류"는 같은 에러예요?
네, 같은 ORA-06502예요. 예전 버전 문구가 "수치 또는 값 오류"이고, 23ai에서는 "값 또는 변환 오류" 뒤에 구체적인 이유가 붙어요.
문자를 숫자로 변환 오류가 나는 행은 어떻게 찾아요?
SELECT ... WHERE VALIDATE_CONVERSION(컬럼 AS NUMBER) = 0을 실행하세요. 이 실습에서는 '1,200' 행만 나왔어요.
ORA-06502가 몇 번째 줄에서 났는지 어떻게 알아요?
에러 아래 ORA-06512: at line N을 보세요. 이 예제들에서는 실패한 SELECT INTO나 대입문 줄을 가리켰어요.
검증 방법
시나리오마다 새 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