Oracle データベースを利用していると、**「ORA-06502: PL/SQL: 数値または値エラー」**というエラーに遭遇することがあります。これは比較的よく見られるエラーの一つで、主に「データ型の不一致」や「文字列長の超過」が原因です。この記事では、このエラーの代表的な原因と解決方法を解説します。
ORA-06502 エラーの意味
エラーメッセージ全文は以下のようになります。
このエラーは、PL/SQL 実行時に「値が期待されるデータ型に収まらない」場合に発生します。例えば以下のケースです。
-
数値型の変数に、文字列を代入しようとした場合
-
VARCHAR2 の長さ制限を超える文字列を代入した場合
-
型変換関数（TO_NUMBER, TO_DATE など）が失敗した場合
よくある原因と解決方法
1. 文字列長の超過
解決方法: 変数の長さを見直す、あるいは SUBSTR を利用して長さを調整する。
2. 数値変換エラー
解決方法: 入力値が数値かどうかを事前にチェックする。正規表現を利用するのも有効です。
3. 不正な日付変換
原因: 存在しない日付を変換しようとした。
解決方法: 入力フォーマットをチェックし、妥当な値のみ渡す。
4. 数値桁数のオーバーフロー
解決方法: NUMBER の定義を見直す、または値を丸める。
トラブルシューティングのポイント
-
エラー発生時の 変数定義 を確認する
-
DBMS_OUTPUT.PUT_LINEで 代入しようとしている値 を出力する -
データベースの カラム定義と変数定義の不一致 を確認する
-
外部入力（CSV など）を扱う場合は 入力データの妥当性チェック を行う
まとめ
「ORA-06502」エラーは、ほとんどの場合 データ型の不一致 や 値の範囲超過 が原因です。
再発防止のためには以下が重要です。
-
変数やカラムの定義を余裕を持たせて設計する
-
入力値チェックを徹底する
-
デバッグ時に
DBMS_OUTPUTを活用して値を追跡する
これらを意識することで、エラーを効率的に解消できるはずです。