DBMS_PROFILERの概要

DBMS_PROFILERシステムパッケージは、PLの各行の実行状況を記録し、その結果を集計して、PL実行プロセスにおける各ステートメントの実行時間を詳細に表示するために使用されます。

DBMS_PROFILER権限の説明

このシステムパッケージの権限はAUTHID CURRENT_USERです。

サブプログラムの概要

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

呼び出しの流れ

DBMS_PROFILER.start_profilerを呼び出してパフォーマンスプロファイラーを起動します。これ以降、そのセッション内のすべてのPLの実行における各行の実行回数と所要時間が記録されます。システムのウォームアップが必要な場合、ウォームアッププロセスが記録されるのを防ぐために、DBMS_PROFILER.pause_profilerでプロファイラーを一時停止し、システムのウォームアップ完了後にDBMS_PROFILER.resume_profilerで実行状況の記録を開始します。システムでパフォーマンス分析が必要なPLの実行が終了したら、DBMS_PROFILER.stop_profilerを呼び出してパフォーマンスプロファイラーを停止します。すべての記録データは統計テーブルに集計され、統計テーブルをクエリすることでパフォーマンスを分析します。

以下の図のように：

使用例

1. ストアドプロシージャPROC1を作成します。

   obclient> CREATE OR REPLACE PROCEDURE PROC1 AS
   BEGIN
       NULL;
   END;
   /
   

2. ストアドプロシージャPROC0を作成します。

   obclient> CREATE OR REPLACE PROCEDURE PROC0 AS
   BEGIN
       PROC1();
   END;
   /
   

3. パフォーマンス分析ツールを起動します。

   obclient> CALL DBMS_PROFILER.start_profiler();
   

4. PROC0ストアドプロシージャを呼び出します。

   obclient> CALL PROC0();
   

   PROC0ストアドプロシージャを実行します。パフォーマンス分析ツールが既に起動しているため、この呼び出しのデータは後の分析に使用するため収集されます。

5. パフォーマンス分析ツールを閉じます。

   obclient> CALL DBMS_PROFILER.stop_profiler();
   

6. パフォーマンス分析の実行情報を確認します。

   obclient> SELECT * FROM PLSQL_PROFILER_RUNS;
   

   実行結果：

   +-------+-------------+-----------+-----------+-------------+----------------+-----------------+--------------+--------+
   | RUNID | RELATED_RUN | RUN_OWNER | RUN_DATE  | RUN_COMMENT | RUN_TOTAL_TIME | RUN_SYSTEM_INFO | RUN_COMMENT1 | SPARE1 |
   +-------+-------------+-----------+-----------+-------------+----------------+-----------------+--------------+--------+
   |     1 |        NULL | SYS       | 10-JAN-25 | 10-JAN-25   |    34000000000 | NULL            | NULL         | NULL   |
   +-------+-------------+-----------+-----------+-------------+----------------+-----------------+--------------+--------+
   1 row in set (0.002 sec)
   

7. 分析対象ユニットの情報を確認します。

   obclient> SELECT * FROM PLSQL_PROFILER_UNITS;
   

   実行結果：

   +-------+-------------+-----------+------------+-----------+----------------+------------+--------+--------+
   | RUNID | UNIT_NUMBER | UNIT_TYPE | UNIT_OWNER | UNIT_NAME | UNIT_TIMESTAMP | TOTAL_TIME | SPARE1 | SPARE2 |
   +-------+-------------+-----------+------------+-----------+----------------+------------+--------+--------+
   |     1 |      500025 | PROCEDURE | SYS        | PROCL     | 10-JAN-25      |          0 |   NULL |   NULL |
   |     1 |      500026 | PROCEDURE | SYS        | PROC0     | 10-JAN-25      |          0 |   NULL |   NULL |
   +-------+-------------+-----------+------------+-----------+----------------+------------+--------+--------+
   2 rows in set (0.004 sec)
   

   PLSQL_PROFILER_UNITS テーブルから、分析された各PL/SQLユニットの関連情報（ユニットタイプ、名前、合計時間など）を照会します。

8. 個々の行レベルのパフォーマンスデータを確認します。

   obclient> SELECT * FROM PLSQL_PROFILER_DATA;
   

   実行結果：

   +-------+-------------+-------+-------------+------------+----------+----------+--------+--------+--------+--------+
   | RUNID | UNIT_NUMBER | LINE# | TOTAL_OCCUR | TOTAL_TIME | MIN_TIME | MAX_TIME | SPARE1 | SPARE2 | SPARE3 | SPARE4 |
   +-------+-------------+-------+-------------+------------+----------+----------+--------+--------+--------+--------+
   |     1 |      500025 |     1 |           1 |        537 |      537 |      537 |   NULL |   NULL |   NULL |   NULL |
   |     1 |      500025 |     3 |           1 |       7118 |     7118 |     7118 |   NULL |   NULL |   NULL |   NULL |
   |     1 |      500026 |     1 |           1 |        406 |      406 |      406 |   NULL |   NULL |   NULL |   NULL |
   |     1 |      500026 |     3 |           1 |   16031017 | 16031017 | 16031017 |   NULL |   NULL |   NULL |   NULL |
   +-------+-------------+-------+-------------+------------+----------+----------+--------+--------+--------+--------+
   4 rows in set (0.002 sec)
   

   PLSQL_PROFILER_DATA テーブルをクエリすることで、各PL/SQLユニット内の特定の行に関する詳細なパフォーマンス統計を確認できます。これには、その行の実行回数、合計実行時間、最小・最大実行時間などが含まれます。