sp_trace_setstatus (Transact-SQL)
Ändert den aktuellen Status der angegebenen Ablaufverfolgung.
.gif "Themenlink (Symbol)")
Transact-SQL-Syntaxkonventionen
Syntax
sp_trace_setstatus [ @traceid = ] trace_id , [ @status = ] status
Argumente
- [ @traceid= ] trace_id
Die ID der Ablaufverfolgung, die geändert werden soll. trace_id ist vom Datentyp int; es gibt keinen Standardwert. Der Benutzer verwendet diesen trace_id-Wert zum Identifizieren, Ändern und Steuern der Ablaufverfolgung. Informationen zum Abrufen von trace_id finden Sie unter fn_trace_getinfo (Transact-SQL).
[ @status= ] status
Gibt die für die Ablaufverfolgung zu implementierende Aktion an. status ist ein Wert vom Datentyp int und weist keinen Standardwert auf.In der folgenden Tabelle sind die Status aufgelistet, die möglicherweise angegeben werden.
Status Beschreibung 0
Beendet die angegebene Ablaufverfolgung.
1
Startet die angegebene Ablaufverfolgung.
2
Schließt die angegebene Ablaufverfolgung und löscht ihre Definition vom Server.
.gif "ms176034.note(de-de,SQL.90).gif")
Hinweis:Eine Ablaufverfolgung muss beendet werden, bevor sie geschlossen werden kann. Eine Ablaufverfolgung muss beendet und geschlossen werden, bevor sie angezeigt werden kann.
Rückgabecodewerte
In der folgenden Tabelle werden die Codewerte beschrieben, die die Benutzer möglicherweise nach Abschluss der gespeicherten Prozedur erhalten.
| Rückgabecode | Beschreibung |
|---|---|
0 |
Kein Fehler. |
1 |
Unbekannter Fehler. |
8 |
Der angegebene Status ist ungültig. |
9 |
Das angegebene Ablaufverfolgungshandle ist ungültig. |
13 |
Nicht genügend Arbeitsspeicher. Wird zurückgegeben, wenn nicht genügend Arbeitsspeicher zum Ausführen der angegebenen Aktion verfügbar ist. |
Wenn die Ablaufverfolgung bereits den angegebenen Status aufweist, gibt SQL Server den Wert 0 zurück.
Hinweise
Parameter aller gespeicherten Prozeduren der SQL-Ablaufverfolgung (sp_trace_xx) weisen eine strikte Typbindung auf. Wenn diese Parameter nicht mit den richtigen Datentypen für Eingabeparameter aufgerufen werden, wie in der Argumentbeschreibung angegeben, gibt die gespeicherte Prozedur einen Fehler zurück.
Berechtigungen
Benutzer müssen über die ALTER TRACE-Berechtigung verfügen.
Siehe auch
Verweis
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)
Andere Ressourcen
Einführung in die SQL-Ablaufverfolgung