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 などを指定します。
specified_name specified_scope に示されたオブジェクトの識別子を指定する任意の LONG VARCHAR パラメーター。
do_commit このプロシージャーによって挿入されるローを自動的にコミットするかどうかを指定する任意の TINYINT パラメーター。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' );