DBMS_DEBUGの概要

DBMS_DEBUGシステムパッケージは、主にサーバー側デバッガーを実装するために使用され、サーバー側PLプログラムをデバッグする方法を提供します。

DBMS_DEBUGシステムパッケージを使用してPLプログラムをデバッグするには、少なくとも2つのデータベースセッションが必要です。1つはターゲットプログラムを実行するTargetセッションであり、もう1つはターゲットプログラムをデバッグするDebugセッションです。

Targetセッションはデバッグのための初期化セッションとして使用され、セッションにマーカーを付けることで、PL Interpreterがデバッグモードで実行され、デバッグイベントを生成します。デバッグイベントが生成されると、そのセッションから発信されます。ほとんどの場合、デバッグイベントは応答を求めて返されます：Interpreterは一時停止し、返事を待ちます。

同時に、デバッグセッションもDBMS_DEBUGを使用して自己初期化を行い、監視対象のターゲットセッションを把握する必要があります。その後、デバッグセッションはDBMS_DEBUGのエントリポイントを呼び出して、ターゲットセッションから発信されたイベントを読み取り、ターゲットセッションと通信を行うことができます。

DBMS_DEBUGはPLコンパイラへのインターフェースを提供していませんが、コンパイラが生成するデバッグ情報に依存しています。デバッグ情報がない場合、パラメータや変数の値をチェックしたり変更したりすることはできません。

DBMS_DEBUGの使用方法

以下のステートメントのいずれかを使用すると（2番目のステートメントはパッケージまたは型本体を再コンパイルします）、既存のPLコードに対してデバッグ情報を生成できます。

ALTER [PROCEDURE | FUNCTION | PACKAGE | TRIGGER | TYPE] <name> COMPILE DEBUG;
ALTER [PACKAGE | TYPE] <name> COMPILE DEBUG BODY;

Breakflags

以下はCONTINUEのbreakflagsパラメータ値です。これらのフラグは組み合わせることができます。

Information Flags

以下の識別子はinfo requestedパラメータとしてSYNCHRONIZE、CONTINUE、およびGET_RUNTIME_INFOに渡すことができます。

DBMS_DEBUGサブプログラムの概要

次の表は、OceanBaseデータベースの現在のバージョンでサポートされているDBMS_DEBUGサブプログラムとその簡単な説明を示しています。