【PL/SQL】IN・OUT・IN OUTパラメータの完全ガイド｜使い分け・注意点・NOCOPY・実践パターンまで

PL/SQL でプロシージャやファンクションを定義するとき、パラメータには IN・OUT・IN OUT の3つのモードがあります。モードを正しく指定しないと、値が返ってこない・意図しない値が書き変わるなどのバグが発生します。

この記事では、3つのモードの基本から DEFAULT値・NOCOPYヒント・ファンクションとの使い分けまで、実践コード付きで完全解説します。

IN・OUT・IN OUT の違い一覧

IN パラメータ：値を受け取る（読み取り専用）

最も基本的なモードです。呼び出し元から値を受け取りますが、プロシージャ内で値を変更することはできません。値渡しなので呼び出し元の変数は変わりません。

-- IN パラメータの例
CREATE OR REPLACE PROCEDURE greet_user(
    p_name IN VARCHAR2  -- IN は省略可
) AS
BEGIN
    DBMS_OUTPUT.PUT_LINE('こんにちは、' || p_name || 'さん');
    -- p_name := '別の名前';  ← エラー！IN は代入不可
END;
/

-- 呼び出し方
BEGIN
    greet_user('田中');
    -- → こんにちは、田中さん
END;
/

IN パラメータに DEFAULT 値を設定する

DEFAULT キーワードでデフォルト値を設定すると、引数を省略して呼び出せる オプションパラメータ になります。

CREATE OR REPLACE PROCEDURE log_message(
    p_message  IN VARCHAR2,
    p_severity IN VARCHAR2 DEFAULT 'INFO'  -- 省略可能
) AS
BEGIN
    DBMS_OUTPUT.PUT_LINE('['||p_severity||'] '||p_message);
END;
/

-- severity を省略して呼び出し
BEGIN
    log_message('処理が完了しました');
    -- → [INFO] 処理が完了しました

    log_message('エラーが発生しました', 'ERROR');
    -- → [ERROR] エラーが発生しました
END;
/

OUT パラメータ：結果を返す（書き込み専用）

プロシージャ内で計算した結果を呼び出し元に返すために使います。プロシージャ開始時の値は NULLになるため、読み取りは行わず必ず値を設定して返します。

CREATE OR REPLACE PROCEDURE calc_tax(
    p_price  IN  NUMBER,
    p_tax    OUT NUMBER,
    p_total  OUT NUMBER
) AS
BEGIN
    -- p_tax の入力値は使えない（NULLとして扱われる）
    p_tax   := ROUND(p_price * 0.1);
    p_total := p_price + p_tax;
END;
/

-- 呼び出し方
DECLARE
    v_tax   NUMBER;
    v_total NUMBER;
BEGIN
    calc_tax(1000, v_tax, v_total);
    DBMS_OUTPUT.PUT_LINE('税額: ' || v_tax);    -- → 税額: 100
    DBMS_OUTPUT.PUT_LINE('合計: ' || v_total);  -- → 合計: 1100
END;
/

IN OUT パラメータ：受け取って変換して返す

呼び出し元の値を受け取り、変換・加工して同じ変数に書き戻す場合に使います。呼び出し元の変数が直接書き変わります。

-- 文字列を大文字に変換して上書きするプロシージャ
CREATE OR REPLACE PROCEDURE to_upper_case(
    p_str IN OUT VARCHAR2
) AS
BEGIN
    p_str := UPPER(p_str);
END;
/

DECLARE
    v_str VARCHAR2(100) := 'hello world';
BEGIN
    DBMS_OUTPUT.PUT_LINE(v_str);   -- → hello world
    to_upper_case(v_str);
    DBMS_OUTPUT.PUT_LINE(v_str);   -- → HELLO WORLD
END;
/

NOCOPY ヒント：大きな型を効率的に渡す

OUT・IN OUT は参照渡しですが、Oracle は内部的に一時コピーを作ることがあります。CLOB・BLOB・大きなコレクションを渡す場合、NOCOPY ヒントでコピーを省略してパフォーマンスを改善できます。

CREATE OR REPLACE PROCEDURE process_data(
    p_data IN OUT NOCOPY CLOB  -- コピーを省略
) AS
BEGIN
    -- 大きなCLOBを処理
    DBMS_LOB.WRITEAPPEND(p_data, 10, '追加データ');
END;
/

ファンクション vs プロシージャのパラメータ使い分け

ファンクションは戻り値で1つの値を返せます。複数の値を返す必要がある場合はプロシージャの OUT パラメータを使います。

-- ファンクション版（1つの値を返す場合）
CREATE OR REPLACE FUNCTION calc_tax_fn(
    p_price IN NUMBER
) RETURN NUMBER AS
BEGIN
    RETURN ROUND(p_price * 0.1);
END;
/

-- SQL から直接使用できる
SELECT calc_tax_fn(1000) FROM DUAL;  -- → 100

よくある間違いと対処法

まとめ

あわせて読みたい

• 【PL/SQL】ストアドプロシージャとファンクションの違いと作り方
• 【PL/SQL】バルク処理で高速化！FORALLとBULK COLLECTの使い方
• 【PL/SQL】例外処理の書き方と使い方｜WHEN OTHERSの注意点も解説
• 【PL/SQL】IF文で条件分岐を行う方法
• 【PL/SQL】初心者でもわかる基本構文とブロック構造の書き方