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

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

Procedure: データベースツールおよび SQL プラグインを有効化

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

1. `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) を押して設定を開き、  `プラグイン`  を選択します。

2. データベースツールおよび SQL  プラグインを見つけて   有効化   をクリックします。

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

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

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

Procedure:

1. Oracle​ データソースを右クリックし、  `新規｜クエリコンソール`  を選択します。

Alternatively, select one of the existing クエリコンソールs from   クエリコンソール   list ( `Ctrl+Shift+F10` (Windows), `⌘ ⇧ F10` (macOS), `⌘ ⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ F10` (macOS System Shortcuts), `Ctrl+Shift+F10` (XWin), `Ctrl+Shift+F10` (GNOME), `Ctrl+Shift+F10` (KDE), `Ctrl+Shift+F10` (Emacs), `Ctrl+Shift+F10` (Sublime Text), `⌘ ⇧ F10` (Sublime Text (macOS)), `⌘ ⇧ F10` (Xcode), `Ctrl+Shift+F10` (Visual Studio), `⌘ ⇧ F10` (Visual Studio (macOS)), `Ctrl+Shift+F10` (ReSharper), `⌘ ⇧ F10` (ReSharper (macOS)), `Ctrl+Shift+F10` (QtCreator), `⌘ ⇧ F10` (QtCreator (macOS)), `Ctrl+Shift+F10` (NetBeans), `Ctrl+Shift+F10` (Eclipse), `⌘ ⇧ F10` (Eclipse (macOS))).

2. Type or paste your code in the クエリコンソール.

3. 実行   ボタン ![実行ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.execute.svg) をクリックするか、 `Ctrl+Enter` (Windows), `⌘ ⏎` (macOS), `⌘ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ ⏎` (macOS System Shortcuts), `Ctrl+Enter` (XWin), `Ctrl+Enter` (GNOME), `Ctrl+Enter` (KDE), `Ctrl+Enter` (Emacs), `Ctrl+Enter` (Sublime Text), `⌘ ⏎` (Sublime Text (macOS)), `⌘ ⏎` (Xcode), `Ctrl+Enter` (Visual Studio), `⌘ ⏎` (Visual Studio (macOS)), `Ctrl+Enter` (ReSharper), `⌘ ⏎` (ReSharper (macOS)), `Ctrl+Enter` (QtCreator), `Ctrl+Enter` (QtCreator (macOS)), `Ctrl+Enter` (NetBeans), `Ctrl+Enter` (Eclipse), `⌘ ⏎` (Eclipse (macOS)) を押して手順コードを実行します。

その結果、   データベース   ツールウィンドウ（  `表示 | ツールウィンドウ |   データベース`  ）に作成されたオブジェクトが表示されます。

![PL/SQL オブジェクトを作成する](https://resources.jetbrains.com/help/img/idea/2026.3/pl_sql_debugging_create_procedure.png)

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

```SQL
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;
/

```

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

Procedure:

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

1. デバッグする PL/SQL オブジェクトを右クリックし、  `SQL スクリプト | 再コンパイル`  を選択します。

2. 再コンパイル   ダイアログで、   DEBUG オプションを使用   を選択します。

3. OK   をクリックします。

![デバッグ用のコードをコンパイルする](https://resources.jetbrains.com/help/img/idea/2026.3/pl_sql_debugging_compile_for_debug.png)

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

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

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

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

1. データベース   ツールウィンドウで、デバッグ用に [作成](#step-1-create-a-pl-sql-object)および [コンパイルした](#step-2-compile-a-pl-sql-object-with-the-debug-option)PL/SQL オブジェクトをダブルクリックします。

2. プロシージャの実行   ボタン ![プロシージャの実行ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/database-plugin.icons.procedureRun.svg) をクリックします。 セッションが選択されていない場合は、リストからセッションを選択します。 セッション管理の詳細については、 [セッション](managing-connection-sessions.html) を参照してください。

3. From the   ルーチンの実行   dialog, copy and paste the anonymous block to the クエリコンソール.

4. 匿名ブロックと、この匿名ブロックで参照される PL/SQL プログラムオブジェクトにブレークポイントを配置します。

5. （オプション）パラメーター値を変更します。

6. デバッグ   をクリックします。

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/pl_sql_debugging_run_debug_in_anonymous_block.mp4)

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

```SQL
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;
/

```

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

パッケージは、論理的に関連する PL/SQL 型、項目、サブプログラムをグループ化するスキーマオブジェクトです。

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

1. データベース   ツールウィンドウで、デバッグ用に [作成](#step-1-create-a-pl-sql-object)および [コンパイルした](#step-2-compile-a-pl-sql-object-with-the-debug-option)パッケージをダブルクリックします。

2. パッケージにブレークポイントを配置します。

3. Oracle​ データソースを右クリックし、  `新規｜クエリコンソール`  を選択します。

Alternatively, select one of the existing クエリコンソールs from   クエリコンソール   list ( `Ctrl+Shift+F10` (Windows), `⌘ ⇧ F10` (macOS), `⌘ ⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ F10` (macOS System Shortcuts), `Ctrl+Shift+F10` (XWin), `Ctrl+Shift+F10` (GNOME), `Ctrl+Shift+F10` (KDE), `Ctrl+Shift+F10` (Emacs), `Ctrl+Shift+F10` (Sublime Text), `⌘ ⇧ F10` (Sublime Text (macOS)), `⌘ ⇧ F10` (Xcode), `Ctrl+Shift+F10` (Visual Studio), `⌘ ⇧ F10` (Visual Studio (macOS)), `Ctrl+Shift+F10` (ReSharper), `⌘ ⇧ F10` (ReSharper (macOS)), `Ctrl+Shift+F10` (QtCreator), `⌘ ⇧ F10` (QtCreator (macOS)), `Ctrl+Shift+F10` (NetBeans), `Ctrl+Shift+F10` (Eclipse), `⌘ ⇧ F10` (Eclipse (macOS))).

4. Oracle​ クエリコンソール で、プロシージャをトリガーする匿名ブロックを記述します。

5. デバッグ   をクリックします。

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/pl_sql_debugging_run_debug_packages.mp4)

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

```SQL
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;
/

```

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

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

```

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

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

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

1. Oracle​ データソースを右クリックし、  `新規｜クエリコンソール`  を選択します。

Alternatively, select one of the existing クエリコンソールs from   クエリコンソール   list ( `Ctrl+Shift+F10` (Windows), `⌘ ⇧ F10` (macOS), `⌘ ⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ F10` (macOS System Shortcuts), `Ctrl+Shift+F10` (XWin), `Ctrl+Shift+F10` (GNOME), `Ctrl+Shift+F10` (KDE), `Ctrl+Shift+F10` (Emacs), `Ctrl+Shift+F10` (Sublime Text), `⌘ ⇧ F10` (Sublime Text (macOS)), `⌘ ⇧ F10` (Xcode), `Ctrl+Shift+F10` (Visual Studio), `⌘ ⇧ F10` (Visual Studio (macOS)), `Ctrl+Shift+F10` (ReSharper), `⌘ ⇧ F10` (ReSharper (macOS)), `Ctrl+Shift+F10` (QtCreator), `⌘ ⇧ F10` (QtCreator (macOS)), `Ctrl+Shift+F10` (NetBeans), `Ctrl+Shift+F10` (Eclipse), `⌘ ⇧ F10` (Eclipse (macOS))).

2. Type a query in the クエリコンソール.

3. トリガーにブレークポイントを配置します。

4. デバッグ   をクリックします。

[Video](https://resources.jetbrains.com/help/img/idea/2026.3/pl_sql_debugging_run_debug_triggers.mp4)

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

```SQL
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 の公式ドキュメント(英語)](https://docs.oracle.com/database/121/ARPLS/d_debug.htm#ARPLS66129)を参照してください。 有効なブレークポイントが設定されていない場合、デバッガーはルーチン全体を実行します。

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

1. 設定を開き（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ）、  `ビルド、実行、デプロイツール | デバッガー | ステップ`  に移動します。

2. ステップモード   リストから、必要なステップモードを選択します。

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

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

1. 設定を開き（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) ）、  `ビルド、実行、デプロイツール | デバッガー | ステップ`  に移動します。

2. 開始時に一時停止   を選択します。

![デバッグ可能なコードの先頭で一時停止](https://resources.jetbrains.com/help/img/idea/2026.3/db_pause_at_debuggable_code.svg)

