ORA-06502: PL/SQL: 値または変換エラー

ORA-06502: PL/SQL: 値または変換エラー: 文字列バッファが小さすぎます。が発生しました
ORA-06502: PL/SQL: value or conversion error: character string buffer too small

PL/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の行を指します。

原因と対処法

  1. VARCHAR2変数が列の値より短い
  2. '1,200'のような文字をNUMBER変数に代入
  3. NUMBER(p)変数が結果より小さい

1VARCHAR2変数が列の値より短い

nameをv_name VARCHAR2(10)に読み込んでいます。1人目のKimは正常に出力されました。2人目のNorthwind Trading Companyは25文字なので「文字列バッファが小さすぎます」で止まり、5行目のSELECT INTOを指しました。

変数をcustomer.name%TYPEで宣言すると、常に列のサイズに合わせられます。変更後は2行とも出力されました。

事前準備
事前準備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

関連エラー