「PL/SQL」タグアーカイブ

Oracle「ORA-06502: PL/SQL 数値または値エラー」エラーが出た時の解決方法

2025年9月28日管理者コメントする

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 を活用して値を追跡する

これらを意識することで、エラーを効率的に解消できるはずです。

Oracle, SQL, データベース, ブログ

PL/SQL：BULK COLLECTとFORALLを使った効率的な大量データ処理

2025年9月17日管理者コメントする

Oracle PL/SQLを使って大量データを処理する際、1行ずつループして処理を行うとパフォーマンスが低下します。
このようなケースで活躍するのが BULK COLLECT と FORALL です。

これらを活用することで、SQLとPL/SQL間のコンテキスト切り替えを最小限に抑え、大量データを効率的に処理できます。

BULK COLLECTとは？

BULK COLLECTは、複数行のデータを一括でコレクション（配列型変数）に格納する仕組みです。

基本構文

使用例

DECLARE
  TYPE t_emp IS TABLE OF employees%ROWTYPE;
  l_emp t_emp;
BEGIN
  SELECT * 
  BULK COLLECT INTO l_emp
  FROM employees
  WHERE department_id = 10;

  DBMS_OUTPUT.PUT_LINE('取得件数: ' || l_emp.COUNT);
END;

DECLARE

TYPE t_emp IS TABLE OF employees%ROWTYPE;

l_emp t_emp;

BEGIN

SELECT *

BULK COLLECT INTO l_emp

FROM employees

WHERE department_id = 10;

DBMS_OUTPUT.PUT_LINE('取得件数: ' || l_emp.COUNT);

END;

✅ 通常のSELECT INTOでは1行しか取得できませんが、BULK COLLECTを使うと複数行をまとめて変数に格納できます。

FORALLとは？

FORALLは、コレクションに格納されたデータを使って一括処理（INSERT/UPDATE/DELETE）を行う構文です。

基本構文

使用例

DECLARE
  TYPE t_empno IS TABLE OF employees.employee_id%TYPE;
  l_empno t_empno;
BEGIN
  -- 部署ID 20の社員IDをまとめて取得
  SELECT employee_id
  BULK COLLECT INTO l_empno
  FROM employees
  WHERE department_id = 20;

  -- 一括で給与を10%アップ
  FORALL i IN l_empno.FIRST .. l_empno.LAST
    UPDATE employees
    SET salary = salary * 1.1
    WHERE employee_id = l_empno(i);

  COMMIT;
END;

DECLARE

TYPE t_empno IS TABLE OF employees.employee_id%TYPE;

l_empno t_empno;

BEGIN

-- 部署ID 20の社員IDをまとめて取得

SELECT employee_id

BULK COLLECT INTO l_empno

FROM employees

WHERE department_id = 20;

-- 一括で給与を10%アップ

FORALL i IN l_empno.FIRST .. l_empno.LAST

UPDATE employees

SET salary = salary * 1.1

WHERE employee_id = l_empno(i);

COMMIT;

END;

✅ FORループで1件ずつUPDATEするよりも大幅に高速化できます。

BULK COLLECTとFORALLを組み合わせる

実務では、BULK COLLECTで一括取得 → FORALLで一括更新／削除といった流れがよく使われます。

処理フロー例

BULK COLLECTで対象データを配列に取得
配列の内容をFORALLで一括更新
コミット

このように組み合わせることで、バッチ処理や大量データ更新におけるパフォーマンスを劇的に改善できます。

パフォーマンス比較

従来のループ処理
SQLとPL/SQL間で行き来が多くなり、数万件以上の処理では遅くなる
BULK COLLECT + FORALL
コンテキストスイッチが最小化され、処理速度が数倍〜数十倍向上するケースもある

注意点

BULK COLLECTで一度に大量データを取得するとメモリ不足の可能性あり
→ LIMIT句を組み合わせて分割取得が推奨
FORALLはDML専用（SELECTでは使えない）
例外処理はSAVE EXCEPTIONSを付けて制御することも可能

まとめ

BULK COLLECT → 複数行を一括取得
FORALL → 複数行を一括処理
大量データ処理では必須テクニック
メモリ管理や例外処理に注意しつつ使うと、バッチ処理の効率が大幅に改善

💡 実際のプロジェクトでは「数十万件以上のデータ更新」で特に効果が出やすいため、PL/SQLチューニングの定番として覚えておきましょう。

SQL, ブログ

Oracle：DECODE関数とCASE式の違いを徹底解説

2025年9月13日管理者コメントする

Oracle SQLを学んでいると、「DECODE関数」と「CASE式」の使い分けで迷う方は多いのではないでしょうか。
どちらも条件分岐を行うために利用できますが、機能や表現力には明確な違いがあります。

本記事では、DECODEとCASEの特徴、違い、実務での使い分けポイントをわかりやすく解説します。

1. DECODE関数とは？

DECODE は Oracle独自の関数 で、簡易的な条件分岐を行うために利用されます。
基本構文は次の通りです。

指定した式の値と「検索値」が一致すれば、その「置換値」を返す
一致しなければ最後のデフォルト値を返す（省略可能）

例：部署IDに応じて部署名を返す

2. CASE式とは？

CASE は SQL標準 でサポートされる条件分岐の構文です。
Oracleだけでなく、他のデータベース（MySQL、PostgreSQLなど）でも使えます。

構文（シンプルCASE）

構文（検索CASE）

例：部署IDに応じて部署名を返す

3. DECODEとCASEの比較

項目	DECODE	CASE
標準SQL	Oracle独自機能	SQL標準でサポート
構文	関数形式	式形式
条件	「等しい場合」のみ判定可能	!ERROR! C4 -> Formula Error: Unexpected ,
可読性	ネストが増えると読みにくい	複雑な条件もわかりやすく記述可能
移植性	Oracleに依存	他DBでも利用可能
推奨度	古いコードに多い	現在はこちらが主流

4. 実務での使い分けポイント

既存システムのSQLでDECODEが多用されている → 互換性を保つためそのまま使用するケースあり
新規開発や複雑な条件分岐 → 可読性・移植性を考えて CASE式を推奨
DB移行を見据える場合 → CASE式を選択しておくと移植がスムーズ

まとめ

DECODE関数：Oracle独自。簡単な条件分岐向け。古いSQLでよく見かける。
CASE式：SQL標準。複雑な条件も書けて、移植性・可読性に優れる。

👉 今後の開発では CASE式を優先的に利用 するのがおすすめです。

覚え書き.com

「PL/SQL」タグアーカイブ

Oracle「ORA-06502: PL/SQL 数値または値エラー」エラーが出た時の解決方法

ORA-06502 エラーの意味

よくある原因と解決方法

1. 文字列長の超過

2. 数値変換エラー

3. 不正な日付変換

4. 数値桁数のオーバーフロー

トラブルシューティングのポイント

まとめ

PL/SQL：BULK COLLECTとFORALLを使った効率的な大量データ処理

BULK COLLECTとは？

基本構文

使用例

FORALLとは？

基本構文

使用例

BULK COLLECTとFORALLを組み合わせる

処理フロー例

パフォーマンス比較

注意点

まとめ

Oracle：DECODE関数とCASE式の違いを徹底解説

1. DECODE関数とは？

例：部署IDに応じて部署名を返す

2. CASE式とは？

構文（シンプルCASE）

構文（検索CASE）

例：部署IDに応じて部署名を返す

3. DECODEとCASEの比較

4. 実務での使い分けポイント

まとめ

「駑馬十駕」を信念に IT系情報を中心に調べた事をコツコツ綴っています。

ORA-06502 エラーの意味

よくある原因と解決方法

1. 文字列長の超過

2. 数値変換エラー

3. 不正な日付変換

4. 数値桁数のオーバーフロー

トラブルシューティングのポイント

まとめ

関連記事

BULK COLLECTとは？

基本構文

使用例

FORALLとは？

基本構文

使用例

BULK COLLECTとFORALLを組み合わせる

処理フロー例

パフォーマンス比較

注意点

まとめ

関連記事

1. DECODE関数とは？

例：部署IDに応じて部署名を返す

2. CASE式とは？

構文（シンプルCASE）

構文（検索CASE）

例：部署IDに応じて部署名を返す

3. DECODEとCASEの比較

4. 実務での使い分けポイント

まとめ

関連記事

「駑馬十駕」を信念に IT系情報を中心に調べた事をコツコツ綴っています。

　関連記事

　関連記事

　関連記事