ALTER TRACE EVENT SESSION-Anweisung

Ermöglicht das Hinzufügen oder Entfernen von Trace-Ereignissen in einer Sitzung, das Hinzufügen oder Entfernen von Zielen in einer Sitzung sowie das Starten und Stoppen einer Trace-Sitzung.

Syntax

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

Parameter

ADD TRACE EVENT Der Name des Trace-Ereignisses, das zur Sitzung hinzugefügt wird.

DROP TRACE EVENT Der Name des Trace-Ereignisses, das aus der Sitzung entfernt wird.

ADD TARGET Der Name des Ziels, das zur Sitzung hinzugefügt wird. Informationen zu den Trace-Ereignissen, die Teil der Sitzung sind, werden in diesem Ziel protokolliert.

DROP TARGET Der Name des Ziels, das aus der Sitzung entfernt wird.

Das Hinzufügen bzw. Löschen von Trace-Ereignissen oder Zielen in einer laufenden Trace-Sitzung führt dazu, dass die Sitzung kurz unterbrochen wird, um die Änderungen vorzunehmen, und anschließend wieder aufgenommen wird. Sie müssen eine Protokollierungssitzung nicht stoppen, um Trace-Ereignisse oder Ziele hinzuzufügen oder zu löschen. Das Hinzufügen bzw. Löschen eines Trace-Ereignisses aus einer Sitzung, die bereits gestartet wurde, hat die Nebenwirkung, dass einige Trace-Ereignisse verpasst werden, während die Sitzung vorübergehend unterbrochen wird.

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;

Kommentieren Sie diese Seite in DocCommentXchange.