ツイートはてブ LINE Pocket

Oracle PL/SQL コードのデバッグ

データベースツールと SQL プラグインを有効にする

この機能は、PhpStorm にデフォルトでバンドルされ有効になっているデータベースツールと SQL プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。

Ctrl+Alt+S を押して設定を開き、プラグインを選択します。
インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。

デバッガーは、DBMS_DEBUG パッケージの API を使用する Oracle プローブに基づいており、Oracle サーバー 9.0 以降で動作するはずです。

Oracle では、次のプログラムユニット（PL/SQL プログラム）をデバッグできます: 匿名ブロック、パッケージ、プロシージャ、関数、トリガー。

ステップ 1. PL/SQL オブジェクトを作成する

Oracle データソースを右クリックし、新規 | クエリコンソールを選択します。
または、クエリコンソールリスト (Ctrl+Shift+F10) から既存のクエリファイルの 1 つを選択します。
クエリファイルにコードを入力または貼り付けます。
実行ボタンをクリックするか、Ctrl+Enter を押して手順コードを実行します。
その結果、作成されたオブジェクトがデータベースツールウィンドウ ( 表示 | ツールウィンドウ | データベース ) に表示されます。

プロシージャのコードスニペット:

CREATE PROCEDURE simpleprocedure (inval NUMBER) IS tmpvar NUMBER; tmpvar2 NUMBER; total NUMBER; BEGIN tmpvar := 0; tmpvar2 := 0; total := 0; FOR lcv IN 1 .. inval LOOP total := 2 * total + 1 - tmpvar2; tmpvar2 := tmpvar; tmpvar := total; END LOOP; DBMS_OUTPUT.put_line ('TOTAL IS: ' || total); END simpleprocedure; /

ステップ 2. デバッグオプションを使用して PL/SQL オブジェクトをコンパイルする

PL/SQL コードのデバッグを有効にするには、DEBUG オプションを使用してコンパイルする必要があります。コンパイルのプロセスにより、PL/SQL コードが Pro * C に変換され、Pro * C が Oracle 共有ライブラリにコンパイルされます。コンパイルは、Oracle インタープリターがコードをより高速に処理できます。

デバッグする PL/SQL オブジェクトを右クリックし、SQL スクリプト | 再コンパイルを選択します。
再コンパイルダイアログで、DEBUG オプションを使用を選択します。
OK をクリックします。

ステップ 3. PL/SQL プログラムユニットのデバッグ

無名ブロックを介した PL/SQL プロシージャおよびファンクションのデバッグ

PL/SQL プログラムユニットは、コードをブロックに編成します。名前のないブロックは、匿名ブロックです。匿名ブロックは、Oracle データベースには保存されません。デバッグプロセスでは、匿名ブロックを使用してパラメーターの値を渡します。

プロシージャ、パッケージ、関数をデバッグするには、必要なルーチンを呼び出す匿名ブロックを作成します。

データベースツールウィンドウで、デバッグ用に作成およびコンパイルした PL/SQL オブジェクトをダブルクリックします。
プロシージャの実行ボタンをクリックします。セッションが選択されていない場合は、リストからセッションを選択します。セッション管理の詳細については、「セッション」を参照してください。
ルーチンの実行ダイアログから、匿名ブロックをコピーしてクエリファイルに貼り付けます。
匿名ブロックと、この匿名ブロックで参照される PL/SQL プログラムオブジェクトにブレークポイントを配置します。
（オプション）パラメーター値を変更します。
デバッグをクリックします。

プロシージャのコードスニペット:

無名ブロックを介した PL/SQL パッケージのデバッグ

パッケージは、論理的に関連する PL/SQL タイプ、アイテムおよびサブプログラムをグループ化するスキーマオブジェクトです。

プロシージャや関数と同様に、パッケージをデバッグするには、必要なルーチンを呼び出す匿名ブロックを作成します。

データベースツールウィンドウで、デバッグ用に作成およびコンパイルしたパッケージをダブルクリックします。
パッケージにブレークポイントを配置します。
Oracle データソースを右クリックし、新規 | クエリコンソールを選択します。
または、クエリコンソールリスト (Ctrl+Shift+F10) から既存のクエリファイルの 1 つを選択します。
Oracle クエリファイルで、プロシージャをトリガーする匿名ブロックを記述します。
デバッグをクリックします。

パッケージのコードスニペット:

CREATE PACKAGE PKG_DBGD AS FUNCTION tst_1(I IN INTEGER) RETURN INTEGER; FUNCTION tst_2(I IN INTEGER) RETURN INTEGER; END PKG_DBGD; / CREATE PACKAGE BODY PKG_DBGD AS FUNCTION tst_1(I IN INTEGER) RETURN INTEGER IS BEGIN IF I BETWEEN 5 AND 10 THEN RETURN 2 * I; END IF; IF I BETWEEN 0 AND 4 THEN RETURN tst_2(3 + I); END IF; IF I BETWEEN 6 AND 10 THEN RETURN tst_2(I - 2); END IF; RETURN I; END TST_1; FUNCTION tst_2(I IN INTEGER) RETURN INTEGER IS BEGIN IF I BETWEEN 6 AND 8 THEN RETURN tst_1(I - 1); END IF; IF I BETWEEN 1 AND 5 THEN RETURN I * 2; END IF; RETURN I - 1; END TST_2; END PKG_DBGD; /

匿名ブロックのコードスニペット:

DECLARE V_RESULT INTEGER; BEGIN V_RESULT := PKG_DBGD.tst_1(4); END;

クエリを介した PL/SQL トリガーのデバッグ

トリガーは、INSERT、UPDATE、DELETE クエリを発行したときに DBMS によって自動的に呼び出される PL/SQL プログラムユニットです。トリガーはテーブルに関連付けられており、データ行を挿入、更新、削除する前または後に呼び出されます。テーブルには複数のトリガーを設定できます。

トリガーをデバッグするには、テーブルまたはビューに INSERT、UPDATE、DELETE クエリを書き込みます。

Oracle データソースを右クリックし、新規 | クエリコンソールを選択します。
または、クエリコンソールリスト (Ctrl+Shift+F10) から既存のクエリファイルの 1 つを選択します。
クエリファイルにクエリを入力します。
トリガーにブレークポイントを配置します。
デバッグをクリックします。

トリガーのコードスニペット:

create table Table_with_Triggers ( Code char(1), Name varchar(26) ) / create trigger Table_with_Triggers_Trg_1 before update on Table_with_Triggers declare x positive := 42; begin dbms_output.put_line('trigger before update statement'); end; / create trigger Table_with_Triggers_Trg_2 before update on Table_with_Triggers for each row begin dbms_output.put_line('trigger before update row '||:old.Code); end; / create trigger Table_with_Triggers_Trg_3 after update on Table_with_Triggers for each row begin dbms_output.put_line('trigger after update row '||:old.Code); end; / create trigger Table_with_Triggers_Trg_4 after update on Table_with_Triggers begin dbms_output.put_line('trigger after update statement'); end; / insert into Table_with_Triggers values ('A', 'Altai'); insert into Table_with_Triggers values ('B', 'Barnaul'); commit; alter trigger Table_with_Triggers_Trg_1 compile debug; alter trigger Table_with_Triggers_Trg_2 compile debug; alter trigger Table_with_Triggers_Trg_3 compile debug; alter trigger Table_with_Triggers_Trg_4 compile debug; begin dbms_output.enable(4000); end; / begin update Table_with_Triggers set Name = Name || '+'; end; / update Table_with_Triggers set Name = Name || '+' / rollback / select * from user_source /

ステップモード

PL/SQL コードをデバッグするとき、グレースフルおよびネイティブの 2 つのステップモードから選択できます。

グレースフルモードでは、デバッグするセッション（ターゲットセッション）を一時停止し、ブレークポイントを設定および削除できます。有効なブレークポイントが設定されていない場合、デバッガーは行単位でコードをステップ実行します。

ネイティブモードでは、デバッガーは Oracle ネイティブデバッグコマンドを使用します。ターゲットセッションを一時停止したり、ブレークポイントを管理したりすることはできませんが、CPU 負荷の高い操作（多くの計算やループを含む操作）ではパフォーマンスが向上する可能性があります。Oracle デバッグコマンドの詳細については、Oracle の公式ドキュメント(英語)を参照してください。有効なブレークポイントが設定されていない場合、デバッガーはルーチン全体を実行します。

ステップモードを変更する

設定を開き（Ctrl+Alt+S）、ビルド、実行、デプロイ | デバッガー | ステップに移動します。
ステップモードリストから、必要なステップモードを選択します。

デバッグ可能なコードの先頭で一時停止

デバッグ可能なコードの最初でデバッガーを一時停止させることができます。デバッガーが一時停止する場所は自動的に検出されます。宣言セクションで変数値を割り当てると、デバッガーは変数宣言で一時停止します。変数に値が割り当てられていない場合、デバッガーは宣言セクションをスキップし、実行セクションの BEGIN キーワードで一時停止します。