Megosztás a következőn keresztül:

sp_trace_setstatus (Transact-SQL)

A következőkre vonatkozik:SQL Server

Módosítja a megadott nyomkövetés aktuális állapotát.

Fontos

Ez a funkció az SQL Server egy későbbi verziójában lesz eltávolítva. Ne használja ezt a funkciót az új fejlesztési munkában, és tervezze meg a funkciót jelenleg használó alkalmazások módosítását. Használja helyette a Bővített események parancsot.

Transact-SQL szintaxis konvenciói

Szintaxis

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

Érvek

Fontos

A kiterjesztett tárolt eljárások argumentumait a Szintaxis szakaszban leírt sorrendben kell megadni. Ha a paraméterek sorrenden kívül vannak beírva, hibaüzenet jelenik meg.

[ @traceid = ] traceid

A módosítani kívánt nyomkövetés azonosítója. @traceidint, alapértelmezés nélkül. A felhasználó ezt a @traceid értéket alkalmazza a nyomkövetés azonosítására, módosítására és szabályozására. A @traceidbeolvasásával kapcsolatos információkért lásd: sys.fn_trace_getinfo.

[ @status = ] állapot

Megadja a nyomkövetésen megvalósítandó műveletet. @status alapértelmezés nélkül int.

Az alábbi táblázat a megadható állapotot sorolja fel.

Állapot Leírás
0 Leállítja a megadott nyomkövetést.
1 Elindítja a megadott nyomkövetést.
2 Bezárja a megadott nyomkövetést, és törli annak definícióját a kiszolgálóról.

Jegyzet

A nyomkövetést először le kell állítani, mielőtt bezárható lenne. A nyomkövetést először le kell állítani és le kell zárni, mielőtt megtekinthető lenne.

Kódértékek visszaadása

Az alábbi táblázat a tárolt eljárás befejezését követően lekérhető kódértékeket ismerteti.

Kód visszaadása Leírás
0 Nincs hiba.
1 Ismeretlen hiba.
8 A megadott állapot érvénytelen.
9 A megadott nyomkövetési leíró érvénytelen.
13 Nincs memóriája. Akkor adja vissza, ha nincs elegendő memória a megadott művelet végrehajtásához.

Ha a nyomkövetés már a megadott állapotban van, az SQL Server 0ad vissza.

Megjegyzések

Az SQL Trace által tárolt összes eljárás (sp_trace_*) paraméterei szigorúan be vannak gépelve. Ha ezek a paraméterek nem a megfelelő bemeneti paraméter adattípusokkal vannak meghívva, az argumentum leírásában megadottak szerint a tárolt eljárás hibát ad vissza.

A nyomkövetési tárolt eljárások használatára példa: Nyomkövetésilétrehozása.

Engedélyek

ALTER TRACE-engedélyt igényel.

Kapcsolódó tartalom

  • Last updated on