ORA-06502: PL/SQL: 値または変換エラー
ORA-06502: PL/SQL: 値または変換エラー: 文字列バッファが小さすぎます。が発生しましたORA-06502: PL/SQL: value or conversion error: character string buffer too smallPL/SQL変数に収まらない値を代入しました。
実機検証済み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)に読み込んでいます。1人目のKimは正常に出力されました。2人目のNorthwind Trading Companyは25文字なので「文字列バッファが小さすぎます」で止まり、5行目のSELECT INTOを指しました。
変数をcustomer.name%TYPEで宣言すると、常に列のサイズに合わせられます。変更後は2行とも出力されました。
事前準備
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