ALTER TRACE EVENT SESSION session-name 
{ add-drop-trace-event [,...]  
  |  add-drop-target [, ...] ]
  | STATE = { START | STOP }
}

add-drop-trace-event :
{ ADD TRACE EVENT trace-event-name ... | DROP TRACE EVENT trace-event-name }

add-drop-target :
{ ADD TARGET target-name ... | DROP TARGET target-name }

target-name : filename

実行中のトレースセッションでトレースイベントやターゲットを追加または削除すると、セッションが一時的に停止して変更が行われ、変更が終わると再開されます。トレースイベントやターゲットを追加または削除するためにトレースセッションを停止する必要はありません。すでに開始されているセッションでトレースイベントを追加または削除すると、セッションが一時的に停止している間にいくつかのトレースイベントが失われる副作用があります。

MANAGE ANY TRACE SESSION システム権限が必要です。

なし

• イベントのトレース
• CREATE TEMPORARY TRACE EVENT 文
• CREATE TEMPORARY TRACE EVENT SESSION 文
• DROP TRACE EVENT 文
• DROP TRACE EVENT SESSION 文
• NOTIFY TRACE EVENT 文
• sp_trace_events システムプロシージャ
• sp_trace_event_fields システムプロシージャ
• sp_trace_event_sessions システムプロシージャ
• sp_trace_event_session_events システムプロシージャ
• sp_trace_event_session_targets システムプロシージャ
• sp_trace_event_session_target_options システムプロシージャ
• イベントトレースデータ (ETD) ファイル管理ユーティリティ (dbmanageetd)
• システムイベント

次の例は、my_event というトレースイベントを作成し、my_session というトレースイベントセッションを作成して、セッションを開始します。

CREATE TEMPORARY TRACE EVENT my_event( id INTEGER, information LONG VARCHAR );
CREATE TEMPORARY TRACE EVENT SESSION my_session
    ADD TRACE EVENT my_event, -- user event
    ADD TRACE EVENT SYS_ConsoleLog_Information -- system event
    ADD TARGET FILE ( SET filename_prefix='my_trace_file' ); -- add a target
ALTER TRACE EVENT SESSION my_session
     STATE = START;