sp_trace_setstatus (Transact-SQL)

Artikel
2025-03-11

gäller för:SQL Server

Ändrar det aktuella tillståndet för den angivna spårningen.

Viktig

Den här funktionen tas bort i en framtida version av SQL Server. Undvik att använda den här funktionen i nytt utvecklingsarbete och planera att ändra program som för närvarande använder den här funktionen. Använd Utökade händelser i stället.

Transact-SQL syntaxkonventioner

Syntax

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

Argument

Viktig

Argument för utökade lagrade procedurer måste anges i den specifika ordning som beskrivs i avsnittet Syntax. Om parametrarna anges i fel ordning visas ett felmeddelande.

[ @traceid = ] traceid

ID:t för spårningen som ska ändras. @traceid är int, utan standard. Användaren använder det här @traceid värdet för att identifiera, ändra och kontrollera spårningen. Information om hur du hämtar @traceidfinns i sys.fn_trace_getinfo.

[ @status = ] status

Anger vilken åtgärd som ska implementeras på spårningen. @status är int, utan standard.

I följande tabell visas den status som kan anges.

Status	Beskrivning
`0`	Stoppar den angivna spårningen.
`1`	Startar den angivna spårningen.
`2`	Stänger den angivna spårningen och tar bort dess definition från servern.

Not

En spårning måste stoppas först innan den kan stängas. En spårning måste stoppas och stängas först innan den kan visas.

Returnera kodvärden

I följande tabell beskrivs de kodvärden som du kan få efter att den lagrade proceduren har slutförts.

Returnera kod	Beskrivning
`0`	Inget fel.
`1`	Okänt fel.
`8`	Den angivna statusen är inte giltig.
`9`	Det angivna spårningshandtaget är inte giltigt.
`13`	Slut på minne. Returneras när det inte finns tillräckligt med minne för att utföra den angivna åtgärden.

Om spårningen redan är i det angivna tillståndet returnerar SQL Server 0.

Anmärkningar

Parametrar för alla SQL Trace-lagrade procedurer (sp_trace_*) skrivs strikt. Om dessa parametrar inte anropas med rätt datatyper för indataparametrar, som anges i argumentbeskrivningen, returnerar den lagrade proceduren ett fel.

Ett exempel på hur du använder spårnings lagrade procedurer finns i Skapa en spårning.

Behörigheter

Kräver ALTER TRACE-behörighet.

Dela via