PolarDB:CREATE PACKAGE BODY

構文

CREATE [ OR REPLACE ] PACKAGE BODY name
{ IS | AS }
  [ declaration; ] [, ...]
  [ { PROCEDURE proc_name
      [ (argname [ IN | IN OUT | OUT ] argtype [ DEFAULT value ]
        [, ...]) ]
      [ STRICT ]
      [ LEAKPROOF ]
      [ PARALLEL { UNSAFE | RESTRICTED | SAFE } ]
      [ COST execution_cost ]
      [ ROWS result_rows ]
      [ SET config_param { TO value | = value | FROM CURRENT } ]
    { IS | AS }
        program_body
      END [ proc_name ];
    |
      FUNCTION func_name
      [ (argname [ IN | IN OUT | OUT ] argtype [ DEFAULT value ]
        [, ...]) ]
      RETURN rettype [ DETERMINISTIC ]
      [ STRICT ]
      [ LEAKPROOF ]
      [ PARALLEL { UNSAFE | RESTRICTED | SAFE } ]
      [ COST execution_cost ]
      [ ROWS result_rows ]
      [ SET config_param { TO value | = value | FROM CURRENT } ]
    { IS | AS }
        program_body
      END [ func_name ];
    }
  ] [, ...]
  [ BEGIN
      statement; [, ...] ]
  END [ name ]

説明

CREATE PACKAGE BODY はパッケージ本体を作成します。CREATE OR REPLACE PACKAGE BODY は、新しいパッケージ本体を作成するか、既存のパッケージ本体を置換します。

スキーマ名を指定した場合、パッケージ本体はそのスキーマに作成されます。指定しない場合は、現在のスキーマに作成されます。新しいパッケージ本体の名前は、同じスキーマ内の既存のパッケージ仕様と一致する必要があり、同じスキーマ内の既存のパッケージ本体の名前と重複することはできません。既存のパッケージ本体の定義を更新するには、CREATE OR REPLACE PACKAGE BODY を使用します。

STRICT、LEAKPROOF、PARALLEL、COST、ROWS、および SET キーワードは、PolarDB for PostgreSQL (Compatible with Oracle) の拡張機能を提供し、Oracle データベースではサポートされていません。

パラメーター

例

次の例では、empinfo パッケージのパッケージ本体を作成します。パッケージ本体は、プライベート変数 v_counter を宣言し、get_name プロシージャと display_counter 関数を実装し、パッケージ初期化セクションで v_counter を初期化します。

CREATE OR REPLACE PACKAGE BODY empinfo
IS
    v_counter       INTEGER;
    PROCEDURE get_name (
        p_empno     NUMBER
    )
    IS
    BEGIN
        SELECT ename INTO emp_name FROM emp WHERE empno = p_empno;
        v_counter := v_counter + 1;
    END;
    FUNCTION display_counter
    RETURN INTEGER
    IS
    BEGIN
        RETURN v_counter;
    END;
BEGIN
    v_counter := 0;
    DBMS_OUTPUT.PUT_LINE('Initialized counter');
END;

v_counter はプライベート変数です。パッケージ本体内のすべてのサブプログラムからアクセスできますが、パッケージの外部から直接読み取ったり変更したりすることはできません。パブリック変数 emp_name とパブリック関数 display_counter は、パッケージの状態へのアクセスを制御された形で公開します。

次の 2 つの匿名ブロックは、empinfo パッケージ内のストアドプロシージャと関数を呼び出し、パブリック変数を表示します。

BEGIN
    empinfo.get_name(7369);
    DBMS_OUTPUT.PUT_LINE('Employee Name    : ' || empinfo.emp_name);
    DBMS_OUTPUT.PUT_LINE('Number of queries: ' || empinfo.display_counter);
END;

出力：

Initialized counter
Employee name: SMITH
Number of queries: 1

BEGIN
    empinfo.get_name(7900);
    DBMS_OUTPUT.PUT_LINE('Employee Name    : ' || empinfo.emp_name);
    DBMS_OUTPUT.PUT_LINE('Number of queries: ' || empinfo.display_counter);
END;

出力：

Employee name: JAMES
Number of queries: 2

初期化セクション (BEGIN v_counter := 0;) は、パッケージがセッションで最初に参照されたときに一度だけ実行されます。同じセッション内の後続の呼び出しでは初期化がスキップされるため、クエリのカウンターは両方の匿名ブロックにわたってインクリメントされます。

次のステップ

• CREATE PACKAGE — このパッケージ本文が実装するパッケージ仕様を定義します。

• DROP PACKAGE — パッケージおよびその本文を削除します