sp_trace_setstatus (Transact-SQL)

  • Artikel

Ändert den aktuellen Status der angegebenen Ablaufverfolgung.

Wichtiger HinweisWichtig

Diese Funktion wird in zukünftigen Versionen von Microsoft SQL Server nicht mehr bereitgestellt. Verwenden Sie diese Funktion beim Entwickeln neuer Anwendungen nicht, und planen Sie das Ändern von Anwendungen, in denen es zurzeit verwendet wird. Verwenden Sie stattdessen erweiterte Ereignisse.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

  • [ @traceid= ] trace_id
    Die ID der zu ändernden Ablaufverfolgung. trace_id ist vom Datentyp int und hat 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 sys.fn_trace_getinfo (Transact-SQL).

  • [ @status= ] status
    Gibt die Aktion an, die für die Ablaufverfolgung implementiert werden soll. status ist vom Datentyp int und hat keinen Standardwert.

    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.
    HinweisHinweis

    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

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.

Ein Beispiel zum Verwenden gespeicherter Prozeduren der Ablaufverfolgung finden Sie unter Erstellen einer Ablaufverfolgung (Transact-SQL).

Berechtigungen

Benutzer müssen über die ALTER TRACE-Berechtigung verfügen.

Siehe auch

Verweis

sys.fn_trace_geteventinfo (Transact-SQL)

sys.fn_trace_getfilterinfo (Transact-SQL)

sp_trace_generateevent (Transact-SQL)

sp_trace_setevent (Transact-SQL)

sp_trace_setfilter (Transact-SQL)

Konzepte

SQL-Ablaufverfolgung