Freigeben über


sp_trace_setstatus (Transact-SQL)

Ändert den aktuellen Status der angegebenen Ablaufverfolgung.

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.

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

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

Berechtigungen

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