すべてのプロダクト
Search

このプロダクト

    PolarDB:DBMS_PROFILER

    ドキュメントセンター

    PolarDB:DBMS_PROFILER

    最終更新日:Jun 05, 2024

    DBMS_PROFILERパッケージは、パフォーマンスプロファイリングセッション中に実行されるPL/pgSQLおよびSPLステートメントに関するパフォーマンス情報を収集して保存します。

    次の表に、プロファイリングツールの制御に使用できる関数とストアドプロシージャを示します。

    表1. DBMS_PROFILER関数とストアドプロシージャの
    関数またはストアドプロシージャデータ型戻り値タイプ説明
    FLUSH_DATA関数またはストアドプロシージャステータスコードまたは例外現在のセッションで収集されたパフォーマンスデータをフラッシュします。
    GET_VERSION (メジャーOUT、マイナーOUT)ストアドプロシージャN/ADBMS_PROFILERパッケージのバージョンを返します。
    INTERNAL_VERSION_ CHECK機能ステータスコードDBMS_PROFILERパッケージの現在のバージョンが現在のデータベースと互換性があることを確認します。
    PAUSE_PROFILER関数またはストアドプロシージャステータスコードまたは例外プロファイラーセッションを中断します。
    RESUME_PROFILER関数またはストアドプロシージャステータスコードまたは例外プロファイラーセッションを再開します。
    START_PROFILER (コメントを実行、コメントを実行 [、実行番号OUT ])関数またはストアドプロシージャステータスコードまたは例外プロファイラーセッションを開始します。
    STOP_PROFILER関数またはストアドプロシージャステータスコードまたは例外プロファイラーセッションを停止し、パフォーマンスデータをDBMS_PROFILERテーブルおよびビューにフラッシュします。

    DBMS_PROFILERパッケージ内の関数は、成功または失敗を示すステータスコードを返す。 DBMS_PROFILERパッケージ内のストアドプロシージャは、障害が発生した場合にのみ例外をスローします。 次の表に、関数によって返されるステータスコードとメッセージ、およびストアドプロシージャによってスローされる例外を示します。

    表2. DBMS_PROFILERステータスコードと例外の
    ステータスコードメッセージ例外説明
    -1error versionversion_mismatchプロファイラーのバージョンとデータベースに互換性がありません。
    0successN/A操作は正常終了しました。
    1error_paramprofiler_error指定されたパラメーターの形式が無効な場合に返されるエラーメッセージです。
    2error_ioprofiler_errorフラッシュ操作は失敗します。

    FLUSH_DATA

    FLUSH_DATA関数またはストアドプロシージャは、プロファイラセッションを終了せずに、現在のセッションで収集されたデータをフラッシュします。 データは、PolarDBパフォーマンスガイドで説明されているテーブルにフラッシュされます。 構文: 
    INTEGER FLUSH_DATAステータス

FLUSH_DATA
    のパラメータ
    パラメーター説明
    status返された状態コード。

    GET_VERSION

    GET_VERSIONストアドプロシージャは、DBMS_PROFILERパッケージのバージョンを返します。 構文: 
    GET_VERSION(major OUT INTEGER, minor OUT INTEGER)
    パラメータ
    パラメーター説明
    majorDBMS_PROFILERパッケージのメジャーバージョン。
    minorDBMS_PROFILERパッケージのマイナーバージョン。

    INTERNAL_VERSION_CHECK

    INTERNAL_VERSION_CHECK関数は、DBMS_PROFILERパッケージの現在のバージョンが現在のデータベースと互換性があることを確認します。 構文: 
    status INTEGER INTERNAL_VERSION_CHECK
    パラメーター
    パラメーター説明
    status返された状態コード。

    PAUSE_PROFILER

    PAUSE_PROFILER関数またはストアドプロシージャは、プロファイラーセッションを中断します。 構文: 
    ステータスINTEGER PAUSE_PROFILER

PAUSE_PROFILER
    のパラメータ
    パラメーター説明
    status返された状態コード。

    RESUME_PROFILER

    RESUME_PROFILER関数またはストアドプロシージャは、プロファイラセッションを再開します。 構文: 
    INTEGER RESUME_PROFILERステータス

RESUME_PROFILER
    のパラメータ
    パラメーター説明
    status返された状態コード。

    START_PROFILER

    START_PROFILER関数またはストアドプロシージャは、プロファイラセッションを開始します。 構文: 
    ステータスINTEGER START_PROFILER(run_commentテキスト:= SYSDATE、
  run_comment1テキスト:= '' [, run_number OUT INTEGER ])

START_PROFILER(run_commentテキスト:= SYSDATE、
  パラメータrun_comment1 TEXT := '' [, run_number OUT INTEGER ])
    パラメーター説明
    コメントを実行プロファイラーセッションのカスタムコメント。 デフォルト値はSYSDATEです。
    コメントを実行プロファイラーセッションの追加のカスタムコメント。 デフォルト値はTTです。
    実行番号プロファイラーセッションの数。
    status返された状態コード。

    STOP_PROFILER

    STOP_PROFILER関数またはストアドプロシージャは、プロファイラセッションを停止し、パフォーマンス情報をDBMS_PROFILERテーブルおよびビューにフラッシュします。 構文: 
    INTEGER STOP_PROFILERステータス

STOP_PROFILER
    のパラメータ
    パラメーター説明
    status返された状態コード。