ORA-06502: PL/SQL: 값 또는 변환 오류

ORA-06502: PL/SQL: 값 또는 변환 오류 : 문자열 버퍼가 너무 작습니다
ORA-06502: PL/SQL: value or conversion error: character string buffer too small

PL/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 줄을 가리켜요.

원인별 해결 방법

  1. VARCHAR2 변수가 컬럼 값보다 짧음
  2. '1,200' 같은 문자를 NUMBER 변수에 넣음
  3. NUMBER(p) 변수가 결과보다 작음

1VARCHAR2 변수가 컬럼 값보다 짧음

name을 v_name VARCHAR2(10)에 읽어요. 첫 고객 Kim은 잘 출력됐어요. 두 번째 Northwind Trading Company는 25자라서 "문자열 버퍼가 너무 작습니다"로 멈췄고, 5번째 줄 SELECT INTO를 가리켰어요.

변수를 customer.name%TYPE으로 선언하면 항상 컬럼 크기를 따라가요. 바꾼 뒤 두 행 모두 출력됐어요.

사전 준비
사전 준비lab_a 계정으로 실행
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;
OUTPUT
Table created.


1 row created.


1 row created.


Commit complete.
재현lab_a 계정으로 실행
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;
/
OUTPUT
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/
확인lab_a 계정으로 실행
SELECT cust_id, LENGTH(name) AS len FROM customer ORDER BY cust_id;
OUTPUT
   CUST_ID        LEN
---------- ----------
         1          3
         2         25

2 rows selected.

LENGTH(name)은 3과 25였어요. 테스트에선 잘 돌다가 긴 값이 처음 들어오는 날 나는 경우가 많아요.

해결 후 재실행lab_a 계정으로 실행
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;
/
OUTPUT
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이 출력됐어요.

사전 준비
사전 준비lab_a 계정으로 실행
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;
OUTPUT
Table created.


1 row created.


1 row created.


1 row created.


Commit complete.
재현lab_a 계정으로 실행
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;
/
OUTPUT
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/
확인lab_a 계정으로 실행
SELECT line_no, qty_text FROM upload_line
 WHERE VALIDATE_CONVERSION(qty_text AS NUMBER) = 0;
OUTPUT
   LINE_NO QTY_TEXT
---------- --------------------
         2 1,200

1 row selected.

G는 세션 NLS 설정의 천 단위 구분자예요. 데이터의 구분자가 다르면 먼저 VALIDATE_CONVERSION으로 행을 확인하세요.

해결 후 재실행lab_a 계정으로 실행
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;
/
OUTPUT
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이 출력됐어요.

사전 준비
사전 준비lab_a 계정으로 실행
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;
OUTPUT
Table created.


1 row created.


1 row created.


1 row created.


Commit complete.
재현lab_a 계정으로 실행
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;
/
OUTPUT
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/
확인lab_a 계정으로 실행
SELECT SUM(amount) AS total FROM orders;
OUTPUT
     TOTAL
----------
      1270

1 row selected.

합계는 시간이 지나면 커져요. 합계용 변수는 지금 보이는 값이 아니라 컬럼 타입에 맞추세요.

해결 후 재실행lab_a 계정으로 실행
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;
/
OUTPUT
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

관련 에러