次の方法で共有


sp_trace_setstatus (Transact-SQL)

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

トピック リンク アイコン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

    指定されたトレースを閉じて、その定義をサーバーから削除します。

    ms176034.note(ja-jp,SQL.90).gifメモ :
    トレースを閉じるには、最初にそのトレースを停止する必要があります。トレースを表示するには、最初にそのトレースを停止して閉じる必要があります。

解説

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

権限

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

戻り値

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

戻り値 説明

0

エラーはありません。

1

不明なエラーです。

8

指定した状態は無効です。

9

指定したトレース ハンドルは無効です。

13

メモリが不足しています。指定した操作を実行するための十分なメモリがない場合に返されます。

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

参照

関連項目

fn_trace_geteventinfo (Transact-SQL)
fn_trace_getfilterinfo (Transact-SQL)
sp_trace_generateevent (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)

その他の技術情報

SQL トレースの概要

ヘルプおよび情報

SQL Server 2005 の参考資料の入手