sp_trace_setstatus (Transact-SQL)

Artikel
2025-03-11

van toepassing op:SQL Server-

Hiermee wijzigt u de huidige status van de opgegeven trace.

Belangrijk

Deze functie wordt verwijderd in een toekomstige versie van SQL Server. Vermijd het gebruik van deze functie in nieuwe ontwikkelwerkzaamheden en plan om toepassingen te wijzigen die momenteel gebruikmaken van deze functie. Gebruik in plaats daarvan uitgebreide gebeurtenissen.

Transact-SQL syntaxisconventies

Syntaxis

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

Argumenten

Belangrijk

Argumenten voor uitgebreide opgeslagen procedures moeten worden ingevoerd in de specifieke volgorde, zoals beschreven in de sectie Syntaxis. Als de parameters niet in de volgorde zijn ingevoerd, treedt er een foutbericht op.

[ @traceid = ] traceid

De id van de trace die moet worden gewijzigd. @traceid is int, zonder standaardinstelling. De gebruiker gebruikt deze @traceid waarde om de tracering te identificeren, te wijzigen en te beheren. Zie sys.fn_trace_getinfovoor meer informatie over het ophalen van de @traceid.

[ @status = ] status

Hiermee geeft u de actie die moet worden geïmplementeerd op de tracering. @status is int, zonder standaardinstelling.

De volgende tabel bevat de status die kan worden opgegeven.

Status	Beschrijving
`0`	Stopt de opgegeven tracering.
`1`	Hiermee wordt de opgegeven tracering gestart.
`2`	Hiermee sluit u de opgegeven tracering en verwijdert u de definitie van de server.

Notitie

Een tracering moet eerst worden gestopt voordat deze kan worden gesloten. Een tracering moet eerst worden gestopt en gesloten voordat deze kan worden bekeken.

Codewaarden retourneren

In de volgende tabel worden de codewaarden beschreven die u kunt verkrijgen na voltooiing van de opgeslagen procedure.

Retourcode	Beschrijving
`0`	Geen fout.
`1`	Onbekende fout.
`8`	De opgegeven status is niet geldig.
`9`	De opgegeven traceringsgreep is niet geldig.
`13`	Onvoldoende geheugen. Geretourneerd wanneer er onvoldoende geheugen is om de opgegeven actie uit te voeren.

Als de tracering al de opgegeven status heeft, retourneert SQL Server 0.

Opmerkingen

Parameters van alle opgeslagen SQL Trace-procedures (sp_trace_*) worden strikt getypt. Als deze parameters niet worden aangeroepen met de juiste invoerparametergegevenstypen, zoals opgegeven in de beschrijving van het argument, retourneert de opgeslagen procedure een fout.

Zie Een tracerings-maken voor een voorbeeld van het gebruik van opgeslagen traceringsprocedures.

Machtigingen

Vereist ALTER TRACE-machtiging.

Delen via