sa_set_tracing_level システムプロシージャ

診断トレーシングテーブルに格納するトレーシング情報のレベルを初期化します。

sa_set_tracing_level( 
level 
[, specified_scope
[, specified_name
[, do_commit ] ] ]
)

level 実行する診断トレーシングのレベルを指定する INTEGER パラメータ。使用できる値は、次のとおりです。
- 0 トレーシングデータを生成しません。このレベルは、トレースセッションを開いたままにしますが、トレーシングデータを診断トレーシングテーブルに送信しません。
- 1 基本レベルのトレーシングを設定します。
- 2 中間レベルのトレーシングを設定します。
- 3 高レベルのトレーシングを設定します。
specified_scope トレーシングのスコープを指定する任意の LONG VARCHAR パラメータ。たとえば、USER、DATABASE、CONNECTION_NAME、TRIGGER などを指定します。デフォルトは NULL です。
specified_name specified_scope に示されたオブジェクトの識別子を指定する任意の LONG VARCHAR パラメータ。デフォルトは NULL です。
do_commit このプロシージャによって挿入されるローを自動的にコミットするかどうかを指定する任意の TINYINT パラメータ。デフォルトは 1 です。1 を指定すると、ローは自動的にコミットされます (この設定をおすすめします)。0 を指定すると、ローは自動的にコミットされません。

このプロシージャは、sa_diagnostic_tracing_level テーブルのローを置換し、トレーシングレベルとスコープはプロシージャの呼び出し時に指定した設定に変更されます。

レベル 0 に設定しても、トレースセッションは停止しません。その代わり、トレースセッションはトレーシングデータベースに所属したままで、トレーシングデータは送信されません。レベルが 0 のときでもトレースセッションはアクティブです。

このシステムプロシージャは、プロファイル対象のデータベースから呼び出す必要があります。

次の例は、トレーシングレベルを 1 に設定します。パフォーマンスカウンタデータや実行される文のサンプル用としてデータベース全体をプロファイルします。

CALL sa_set_tracing_level( 1 );

次の例は、トレーシングレベルを 3 に設定し、ユーザ AG84756 を指定します。AG84756 に関連付けられたアクティビティのみがトレースされます。

CALL sa_set_tracing_level( 3, 'user', 'AG84756' );