sp_trace_setstatus (Transact-SQL)

指定したトレースの現在の状態を変更します。

構文

sp_trace_setstatus [ @traceid = ] trace_id , [ @status = ] status

[ @traceid= ] trace_id
変更するトレースの ID を指定します。trace_id のデータ型は int で、既定値はありません。ユーザーは、この trace_id 値を使用して、トレースの識別、変更、および制御を行います。trace_id の取得については、「fn_trace_getinfo (Transact-SQL)」を参照してください。

[ @status= ] status
トレースに実装する操作を指定します。status のデータ型は int で、既定値はありません。

次の表は、指定できる状態の一覧です。

状態	説明
0	指定されたトレースを停止します。
1	指定されたトレースを開始します。
2	指定されたトレースを閉じて、その定義をサーバーから削除します。

注意
トレースを閉じるには、最初にそのトレースを停止する必要があります。トレースを表示するには、最初にそのトレースを停止して閉じる必要があります。

次の表は、このストアドプロシージャの完了時に返されるコード値を示しています。

リターンコード	説明
0	エラーはありません。
1	不明なエラーです。
8	指定した状態は無効です。
9	指定したトレースハンドルは無効です。
13	メモリが不足しています。指定した操作を実行するための十分なメモリがない場合に返されます。

トレースが既に指定した状態である場合は、0 が返されます。

すべての SQL Trace ストアドプロシージャ (sp_trace_xx) のパラメータでは、データ型が厳密に定義されています。これらのパラメータを、引数の説明で指定されている正しいデータ型で指定しないと、このストアドプロシージャはエラーを返します。

トレースストアドプロシージャを使用した例については、「トレースを作成する方法 (Transact-SQL)」を参照してください。

ユーザーに ALTER TRACE 権限が必要です。