sp_trace_setstatus (Transact-SQL)

  • Artikel

Gilt für:SQL Server

Ändert den aktuellen Status der angegebenen Ablaufverfolgung.

Wichtig

Diese Funktion wird in einer zukünftigen Version von SQL Serverentfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden. Verwenden Sie stattdessen erweiterte Ereignisse.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @traceid = ] traceid

Die ID der zu ändernden Ablaufverfolgung. @traceid ist "int" ohne Standard. Der Benutzer verwendet diesen @traceid Wert, um die Ablaufverfolgung zu identifizieren, zu ändern und zu steuern. Informationen zum Abrufen der @traceid finden Sie unter sys.fn_trace_getinfo (Transact-SQL).

[ @status = ] Status

Gibt die Aktion an, die für die Ablaufverfolgung implementiert werden soll. @status ist "int" ohne Standard.

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.

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 nach Abschluss der gespeicherten Prozedur möglicherweise erhalten.

Rückgabecode Beschreibung
0 Kein Fehler.
1 Unbekannter Fehler.
8 Der angegebene Status ist ungültig.
9 Der angegebene Ablaufverfolgungshandle ist ungültig.
13 Nicht genügend Arbeitsspeicher. Wird zurückgegeben, wenn nicht genügend Arbeitsspeicher zum Ausführen der angegebenen Aktion vorhanden ist.

Wenn sich die Ablaufverfolgung bereits im angegebenen Zustand befindet, gibt SQL Server zurück 0.

Hinweise

Parameter aller gespeicherten SQL Trace-Prozeduren (sp_trace_*) werden streng eingegeben. Wenn diese Parameter nicht mit den richtigen Eingabeparameter-Datentypen aufgerufen werden, wie in der Argumentbeschreibung angegeben, gibt die gespeicherte Prozedur einen Fehler zurück.

Ein Beispiel für die Verwendung von gespeicherten Ablaufverfolgungsprozeduren finden Sie unter Erstellen einer Ablaufverfolgung (Transact-SQL).For an example of using trace stored procedures, see Create a Trace (Transact-SQL).

Berechtigungen

Erfordert DIE ALTER TRACE-Berechtigung.

Zugehöriger Inhalt