sp_trace_setevent (Transact-SQL)

Artikel
2025-03-11

gäller för:SQL Server

Lägger till eller tar bort en händelsekolumn i en spårning. sp_trace_setevent kan endast köras på befintliga spårningar som stoppas (@status är 0). Ett fel returneras om den här lagrade proceduren körs på en spårning som inte finns eller vars @status inte är 0.

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_setevent
    [ @traceid = ] traceid
    , [ @eventid = ] eventid
    , [ @columnid = ] columnid
    , [ @on = ] on
[ ; ]

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.

[ @eventid = ] eventid

ID:t för händelsen som ska aktiveras. @eventid är int, utan standard.

Den här tabellen visar de händelser som kan läggas till eller tas bort från en spårning.

Händelsenummer	Händelsenamn	Beskrivning
`0` till `9`	`Reserved`	Reserverad
`10`	`RPC:Completed`	Inträffar när ett fjärrproceduranrop (RPC) har slutförts.
`11`	`RPC:Starting`	Inträffar när en RPC har startats.
`12`	`SQL:BatchCompleted`	Inträffar när en Transact-SQL batch har slutförts.
`13`	`SQL:BatchStarting`	Inträffar när en Transact-SQL batch har startats.
`14`	`Audit Login`	Inträffar när en användare loggar in på SQL Server.
`15`	`Audit Logout`	Inträffar när en användare loggar ut från SQL Server.
`16`	`Attention`	Inträffar när uppmärksamhetshändelser, till exempel begäranden om klientavbrott eller brutna klientanslutningar, inträffar.
`17`	`ExistingConnection`	Identifierar all aktivitet av användare som är anslutna till SQL Server innan spårningen startas.
`18`	`Audit Server Starts and Stops`	Inträffar när SQL Server-tjänsttillståndet ändras.
`19`	`DTCTransaction`	Spårar koordinerade transaktioner med Microsoft Distributed Transaction Coordinator (MS DTC) mellan två eller flera databaser.
`20`	`Audit Login Failed`	Anger att ett inloggningsförsök till SQL Server från en klient misslyckades.
`21`	`EventLog`	Anger att händelser har loggats i Windows-programloggen.
`22`	`ErrorLog`	Anger att felhändelser har loggats i SQL Server-felloggen.
`23`	`Lock:Released`	Anger att ett lås på en resurs, till exempel en sida, har släppts.
`24`	`Lock:Acquired`	Anger förvärv av ett lås på en resurs, till exempel en datasida.
`25`	`Lock:Deadlock`	Anger att två samtidiga transaktioner har låst varandra genom att försöka få inkompatibla lås på resurser som den andra transaktionen äger.
`26`	`Lock:Cancel`	Anger att förvärvet av ett lås på en resurs har avbrutits (till exempel på grund av ett dödläge).
`27`	`Lock:Timeout`	Anger att en begäran om ett lås på en resurs, till exempel en sida, har överskriden tidsgräns på grund av att en annan transaktion har ett blockeringslås på den nödvändiga resursen. Tidsgränsen bestäms av funktionen @@LOCK_TIMEOUT och kan ställas in med SET-LOCK_TIMEOUT-instruktionen.
`28`	`Degree of Parallelism Event`	Inträffar innan en SELECT-, INSERT- eller UPDATE-instruktion körs.
`29` till `31`	`Reserved`	Använd händelse 28 i stället.
`32`	`Reserved`	Reserverad
`33`	`Exception`	Anger att ett undantag har inträffat i SQL Server.
`34`	`SP:CacheMiss`	Anger när en lagrad procedur inte hittas i procedurens cacheminne.
`35`	`SP:CacheInsert`	Anger när ett objekt infogas i procedurens cacheminne.
`36`	`SP:CacheRemove`	Anger när ett objekt tas bort från procedurens cacheminne.
`37`	`SP:Recompile`	Anger att en lagrad procedur kompilerades om.
`38`	`SP:CacheHit`	Anger när en lagrad procedur hittas i procedurens cacheminne.
`39`	`Deprecated`	Deprecated
`40`	`SQL:StmtStarting`	Inträffar när Transact-SQL-instruktionen har startats.
`41`	`SQL:StmtCompleted`	Inträffar när Transact-SQL-instruktionen har slutförts.
`42`	`SP:Starting`	Anger när den lagrade proceduren har startats.
`43`	`SP:Completed`	Anger när den lagrade proceduren har slutförts.
`44`	`SP:StmtStarting`	Anger att en Transact-SQL-instruktion i en lagrad procedur har börjat köras.
`45`	`SP:StmtCompleted`	Anger att en Transact-SQL-instruktion i en lagrad procedur har slutförts.
`46`	`Object:Created`	Anger att ett objekt har skapats, till exempel för CREATE INDEX-, CREATE TABLE- och CREATE DATABASE-instruktioner.
`47`	`Object:Deleted`	Anger att ett objekt har tagits bort, till exempel i DROP INDEX- och DROP TABLE-instruktioner.
`48`	`Reserved`
`49`	`Reserved`
`50`	`SQL Transaction`	Spårar Transact-SQL INSTRUKTIONEN BEGIN, COMMIT, SAVE och ROLLBACK TRANSACTION.
`51`	`Scan:Started`	Anger när en tabell- eller indexgenomsökning har startats.
`52`	`Scan:Stopped`	Anger när en tabell- eller indexgenomsökning har stoppats.
`53`	`CursorOpen`	Anger när en markör öppnas på en Transact-SQL-instruktion av ODBC, OLE DB eller DB-Library.
`54`	`TransactionLog`	Spårar när transaktioner skrivs till transaktionsloggen.
`55`	`Hash Warning`	Anger att en hash-åtgärd (till exempel hashkoppling, hash-aggregering, hash-union och hash-distinkt) som inte bearbetas på en buffertpartition har återställts till en alternativ plan. Detta kan inträffa på grund av rekursionsdjup, datasnedvridning, spårningsflaggor eller biträkning.
`56` till `57`	`Reserved`
`58`	`Auto Stats`	Anger att det har skett en automatisk uppdatering av indexstatistiken.
`59`	`Lock:Deadlock Chain`	Producerad för var och en av händelserna som ledde fram till dödläget.
`60`	`Lock:Escalation`	Anger att ett finkornigt lås har konverterats till ett grovkornigt lås (till exempel eskalerade eller konverterade ett sidlås till ett TABLE- eller HoBT-lås).
`61`	`OLE DB Errors`	Anger att ett OLE DB-fel har inträffat.
`62` till `66`	`Reserved`
`67`	`Execution Warnings`	Anger eventuella varningar som inträffade under körningen av en SQL Server-instruktion eller lagrad procedur.
`68`	`Showplan Text (Unencoded)`	Visar planträdet för Transact-SQL-instruktionen som körs.
`69`	`Sort Warnings`	Anger sorteringsåtgärder som inte får plats i minnet. Omfattar inte sorteringsåtgärder som omfattar skapande av index. sortera endast åtgärder i en fråga (till exempel en ORDER BY-sats som används i en SELECT-instruktion).
`70`	`CursorPrepare`	Anger när en markör på en Transact-SQL-instruktion förbereds för användning av ODBC, OLE DB eller DB-Library.
`71`	`Prepare SQL`	ODBC, OLE DB eller DB-Library har förberett en Transact-SQL-instruktion eller -instruktioner för användning.
`72`	`Exec Prepared SQL`	ODBC, OLE DB eller DB-Library har kört en förberedd Transact-SQL-instruktion eller -instruktioner.
`73`	`Unprepare SQL`	ODBC, OLE DB eller DB-Library har oförberedd (tagit bort) en förberedd Transact-SQL-instruktion eller -instruktioner.
`74`	`CursorExecute`	En markör som tidigare förberetts på en Transact-SQL-instruktion av ODBC, OLE DB eller DB-Library körs.
`75`	`CursorRecompile`	En markör som öppnas på en Transact-SQL-instruktion av ODBC eller DB-Library har omkompilerats antingen direkt eller på grund av en schemaändring. Utlöses för ANSI- och icke-ANSI-markörer.
`76`	`CursorImplicitConversion`	En markör på en Transact-SQL-instruktion konverteras av SQL Server från en typ till en annan. Utlöses för ANSI- och icke-ANSI-markörer.
`77`	`CursorUnprepare`	En förberedd markör på en Transact-SQL-instruktion är oförberedd (borttagen) av ODBC, OLE DB eller DB-Library.
`78`	`CursorClose`	En markör som tidigare öppnats på en Transact-SQL-instruktion av ODBC, OLE DB eller DB-Library stängs.
`79`	`Missing Column Statistics`	Kolumnstatistik som kunde ha varit användbar för optimeraren är inte tillgänglig.
`80`	`Missing Join Predicate`	Frågan som inte är någon kopplingspredikat körs. Detta kan resultera i en tidskrävande fråga.
`81`	`Server Memory Change`	Sql Server-minnesanvändningen har ökat eller minskat med antingen 1 MB eller 5 procent av det maximala serverminnet, beroende på vilket som är störst.
`82` till `91`	`User Configurable (0 - 9)`	Händelsedata som definierats av användaren.
`92`	`Data File Auto Grow`	Anger att en datafil utökades automatiskt av servern.
`93`	`Log File Auto Grow`	Anger att en loggfil utökades automatiskt av servern.
`94`	`Data File Auto Shrink`	Anger att en datafil krympts automatiskt av servern.
`95`	`Log File Auto Shrink`	Anger att en loggfil krympts automatiskt av servern.
`96`	`Showplan Text`	Visar frågeplanträdet för SQL-instruktionen från frågeoptimeraren. Kolumnen `TextData` innehåller inte Showplan för den här händelsen.
`97`	`Showplan All`	Visar frågeplanen med fullständig kompileringstidsinformation om SQL-instruktionen som körs. Kolumnen `TextData` innehåller inte Showplan för den här händelsen.
`98`	`Showplan Statistics Profile`	Visar frågeplanen med fullständig körningsinformation om SQL-instruktionen som körs. Kolumnen `TextData` innehåller inte Showplan för den här händelsen.
`99`	`Reserved`
`100`	`RPC Output Parameter`	Genererar utdatavärden för parametrarna för varje RPC.
`101`	`Reserved`
`102`	`Audit Database Scope GDR`	Inträffar varje gång en GRANT, DENY, REVOKE för en instruktionsbehörighet utfärdas av alla användare i SQL Server för åtgärder endast för databaser, till exempel att bevilja behörigheter för en databas.
`103`	`Audit Object GDR Event`	Inträffar varje gång en GRANT, DENY, REVOKE för en objektbehörighet utfärdas av alla användare i SQL Server.
`104`	`Audit AddLogin Event`	Inträffar när en SQL Server-inloggning läggs till eller tas bort. för `sp_addlogin` och `sp_droplogin`.
`105`	`Audit Login GDR Event`	Inträffar när en Windows-inloggningsrätt har lagts till eller tagits bort. för `sp_grantlogin`, `sp_revokelogin`och `sp_denylogin`.
`106`	`Audit Login Change Property Event`	Inträffar när en egenskap för en inloggning, förutom lösenord, ändras. för `sp_defaultdb` och `sp_defaultlanguage`.
`107`	`Audit Login Change Password Event`	Inträffar när ett lösenord för SQL Server-inloggning ändras. Lösenord registreras inte.
`108`	`Audit Add Login to Server Role Event`	Inträffar när en inloggning läggs till eller tas bort från en fast serverroll. för `sp_addsrvrolemember`och `sp_dropsrvrolemember`.
`109`	`Audit Add DB User Event`	Inträffar när en inloggning läggs till eller tas bort som databasanvändare (Windows eller SQL Server) i en databas. för `sp_grantdbaccess`, `sp_revokedbaccess`, `sp_adduser`och `sp_dropuser`.
`110`	`Audit Add Member to DB Role Event`	Inträffar när en inloggning läggs till eller tas bort som en databasanvändare (fast eller användardefinierad) i en databas. för `sp_addrolemember`, `sp_droprolemember`och `sp_changegroup`.
`111`	`Audit Add Role Event`	Inträffar när en inloggning läggs till eller tas bort som databasanvändare i en databas. för `sp_addrole` och `sp_droprole`.
`112`	`Audit App Role Change Password Event`	Inträffar när ett lösenord för en programroll ändras.
`113`	`Audit Statement Permission Event`	Inträffar när en instruktionsbehörighet (till exempel CREATE TABLE) används.
`114`	`Audit Schema Object Access Event`	Inträffar när en objektbehörighet (till exempel SELECT) används, både utan framgång eller utan framgång.
`115`	`Audit Backup/Restore Event`	Inträffar när ett BACKUP- eller RESTORE-kommando utfärdas.
`116`	`Audit DBCC Event`	Inträffar när DBCC-kommandon utfärdas.
`117`	`Audit Change Audit Event`	Inträffar när spårningsändringar görs.
`118`	`Audit Object Derived Permission Event`	Inträffar när kommandona CREATE, ALTER och DROP utfärdas.
`119`	`OLEDB Call Event`	Inträffar när OLE DB-provideranrop görs för distribuerade frågor och fjärranslutna procedurer.
`120`	`OLEDB QueryInterface Event`	Inträffar när OLE DB-`QueryInterface` anrop görs för distribuerade frågor och fjärranslutna procedurer.
`121`	`OLEDB DataRead Event`	Inträffar när ett anrop för databegäran görs till OLE DB-providern.
`122`	`Showplan XML`	Inträffar när en SQL-instruktion körs. Inkludera den här händelsen för att identifiera Showplan-operatorer. Varje händelse lagras i ett välformat XML-dokument. Kolumnen `Binary` för den här händelsen innehåller den kodade Showplan. Använd SQL Server Profiler för att öppna spårningen och visa Showplan.
`123`	`SQL:FullTextQuery`	Inträffar när en fulltextfråga körs.
`124`	`Broker:Conversation`	Rapporterar förloppet för en Service Broker-konversation.
`125`	`Deprecation Announcement`	Inträffar när du använder en funktion som tas bort från en framtida version av SQL Server.
`126`	`Deprecation Final Support`	Inträffar när du använder en funktion som tas bort från nästa större version av SQL Server.
`127`	`Exchange Spill Event`	Inträffar när kommunikationsbuffertar i en parallell frågeplan tillfälligt har skrivits till `tempdb`-databasen.
`128`	`Audit Database Management Event`	Inträffar när en databas skapas, ändras eller tas bort.
`129`	`Audit Database Object Management Event`	Inträffar när en CREATE-, ALTER- eller DROP-instruktion körs på databasobjekt, till exempel scheman.
`130`	`Audit Database Principal Management Event`	Inträffar när huvudkonton, till exempel användare, skapas, ändras eller tas bort från en databas.
`131`	`Audit Schema Object Management Event`	Inträffar när serverobjekt skapas, ändras eller tas bort.
`132`	`Audit Server Principal Impersonation Event`	Inträffar när det finns en personifiering inom serveromfånget, till exempel KÖR SOM INLOGGNING.
`133`	`Audit Database Principal Impersonation Event`	Inträffar när en personifiering sker inom databasomfånget, till exempel EXECUTE AS USER eller SETUSER.
`134`	`Audit Server Object Take Ownership Event`	Inträffar när ägaren ändras för objekt i serveromfånget.
`135`	`Audit Database Object Take Ownership Event`	Inträffar när en ägarändring för objekt inom databasomfånget sker.
`136`	`Broker:Conversation Group`	Inträffar när Service Broker skapar en ny konversationsgrupp eller släpper en befintlig konversationsgrupp.
`137`	`Blocked Process Report`	Inträffar när en process har blockerats under mer än en angiven tid. Omfattar inte systemprocesser eller processer som väntar på icke-låsbara resurser. Använd `sp_configure` för att konfigurera tröskelvärdet och frekvensen som rapporter genereras med.
`138`	`Broker:Connection`	Rapporterar status för en transportanslutning som hanteras av Service Broker.
`139`	`Broker:Forwarded Message Sent`	Inträffar när Service Broker vidarebefordrar ett meddelande.
`140`	`Broker:Forwarded Message Dropped`	Inträffar när Service Broker släpper ett meddelande som var avsett att vidarebefordras.
`141`	`Broker:Message Classify`	Inträffar när Service Broker avgör routningen för ett meddelande.
`142`	`Broker:Transmission`	Anger att fel har inträffat i Service Broker-transportlagret. Felnumret och tillståndsvärdena anger källan till felet.
`143`	`Broker:Queue Disabled`	Anger att ett giftmeddelande upptäcktes eftersom det fanns fem på varandra följande transaktionsåterställningar i en Service Broker-kö. Händelsen innehåller databas-ID och kö-ID för kön som innehåller giftmeddelandet.
`144` till `145`	`Reserved`
`146`	`Showplan XML Statistics Profile`	Inträffar när en SQL-instruktion körs. Identifierar Showplan-operatorerna och visar fullständiga kompileringsdata. Kolumnen `Binary` för den här händelsen innehåller den kodade Showplan. Använd SQL Server Profiler för att öppna spårningen och visa Showplan.
`148`	`Deadlock Graph`	Inträffar när ett försök att hämta ett lås avbryts eftersom försöket var en del av ett dödläge och valdes som ett dödlägesoffer. Innehåller en XML-beskrivning av ett dödläge.
`149`	`Broker:Remote Message Acknowledgement`	Inträffar när Service Broker skickar eller tar emot en meddelandebekräftelse.
`150`	`Trace File Close`	Inträffar när en spårningsfil stängs under en spårningsfilsåterställning.
`151`	`Reserved`
`152`	`Audit Change Database Owner`	Inträffar när ALTER AUTHORIZATION används för att ändra ägaren till en databas och behörigheter kontrolleras för att göra det.
`153`	`Audit Schema Object Take Ownership Event`	Inträffar när ALTER AUTHORIZATION används för att tilldela en ägare till ett objekt och behörigheter kontrolleras för att göra det.
`154`	`Reserved`
`155`	`FT:Crawl Started`	Inträffar när en fulltextkrypning (population) startar. Använd för att kontrollera om en crawlningsbegäran hämtas av arbetsuppgifter.
`156`	`FT:Crawl Stopped`	Inträffar när en fulltextkrypning (population) stoppas. Stopp inträffar när en crawlning har slutförts eller när ett allvarligt fel inträffar.
`157`	`FT:Crawl Aborted`	Inträffar när ett undantag påträffas under en fulltextkrypning. Vanligtvis stoppas fulltextkrypningen.
`158`	`Audit Broker Conversation`	Rapporterar granskningsmeddelanden som rör dialogsäkerhet för Service Broker.
`159`	`Audit Broker Login`	Rapporterar granskningsmeddelanden som rör Service Broker-transportsäkerhet.
`160`	`Broker:Message Undeliverable`	Inträffar när Service Broker inte kan behålla ett mottaget meddelande som ska ha levererats till en tjänst.
`161`	`Broker:Corrupted Message`	Inträffar när Service Broker tar emot ett skadat meddelande.
`162`	`User Error Message`	Visar felmeddelanden som användarna ser vid fel eller undantag.
`163`	`Broker:Activation`	Inträffar när en köövervakare startar en aktiverings lagrad procedur, skickar ett `QUEUE_ACTIVATION` meddelande eller när en aktiverings lagrad procedur som startas av en köövervakare avslutas.
`164`	`Object:Altered`	Inträffar när ett databasobjekt ändras.
`165`	`Performance statistics`	Inträffar när en kompilerad frågeplan har cachelagrats för första gången, omkompilerats eller tagits bort från plancachen.
`166`	`SQL:StmtRecompile`	Inträffar när en omkompilering på instruktionsnivå inträffar.
`167`	`Database Mirroring State Change`	Inträffar när tillståndet för en speglad databas ändras.
`168`	`Showplan XML For Query Compile`	Inträffar när en SQL-instruktion kompileras. Visar fullständiga kompileringstidsdata. Kolumnen `Binary` för den här händelsen innehåller den kodade Showplan. Använd SQL Server Profiler för att öppna spårningen och visa Showplan.
`169`	`Showplan All For Query Compile`	Inträffar när en SQL-instruktion kompileras. Visar fullständiga kompileringsdata. Använd för att identifiera Showplan-operatorer.
`170`	`Audit Server Scope GDR Event`	Anger att en beviljande-, neka- eller återkalla-händelse för behörigheter i serveromfånget inträffade, till exempel att skapa en inloggning.
`171`	`Audit Server Object GDR Event`	Anger att en beviljande-, neka- eller återkalla-händelse för ett schemaobjekt, till exempel en tabell eller funktion, inträffade.
`172`	`Audit Database Object GDR Event`	Anger att en beviljande-, neka- eller återkalla-händelse för databasobjekt, till exempel sammansättningar och scheman, inträffade.
`173`	`Audit Server Operation Event`	Inträffar när säkerhetsgranskningsåtgärder som att ändra inställningar, resurser, extern åtkomst eller auktorisering används.
`175`	`Audit Server Alter Trace Event`	Inträffar när en instruktion söker efter ALTER TRACE-behörigheten.
`176`	`Audit Server Object Management Event`	Inträffar när serverobjekt skapas, ändras eller tas bort.
`177`	`Audit Server Principal Management Event`	Inträffar när serverhuvudnamn skapas, ändras eller tas bort.
`178`	`Audit Database Operation Event`	Inträffar när databasåtgärder inträffar, till exempel kontrollpunkt eller prenumerationsfrågameddelande.
`180`	`Audit Database Object Access Event`	Inträffar när databasobjekt, till exempel scheman, används.
`181`	`TM: Begin Tran starting`	Inträffar när en `BEGIN TRANSACTION` begäran startar.
`182`	`TM: Begin Tran completed`	Inträffar när en `BEGIN TRANSACTION` begäran slutförs.
`183`	`TM: Promote Tran starting`	Inträffar när en `PROMOTE TRANSACTION` begäran startar.
`184`	`TM: Promote Tran completed`	Inträffar när en `PROMOTE TRANSACTION` begäran slutförs.
`185`	`TM: Commit Tran starting`	Inträffar när en `COMMIT TRANSACTION` begäran startar.
`186`	`TM: Commit Tran completed`	Inträffar när en `COMMIT TRANSACTION` begäran slutförs.
`187`	`TM: Rollback Tran starting`	Inträffar när en `ROLLBACK TRANSACTION` begäran startar.
`188`	`TM: Rollback Tran completed`	Inträffar när en `ROLLBACK TRANSACTION` begäran slutförs.
`189`	`Lock:Timeout (timeout > 0)`	Inträffar när en begäran om ett lås på en resurs, till exempel en sida, överskrider tidsgränsen.
`190`	`Progress Report: Online Index Operation`	Rapporterar förloppet för en onlineindexgenereringsåtgärd medan byggprocessen körs.
`191`	`TM: Save Tran starting`	Inträffar när en `SAVE TRANSACTION` begäran startar.
`192`	`TM: Save Tran completed`	Inträffar när en `SAVE TRANSACTION` begäran slutförs.
`193`	`Background Job Error`	Inträffar när ett bakgrundsjobb avslutas onormalt.
`194`	`OLEDB Provider Information`	Inträffar när en distribuerad fråga körs och samlar in information som motsvarar provideranslutningen.
`195`	`Mount Tape`	Inträffar när en bandmonteringsbegäran tas emot.
`196`	`Assembly Load`	Inträffar när en begäran om att läsa in en CLR-sammansättning inträffar.
`197`	`Reserved`
`198`	`XQuery Static Type`	Inträffar när ett XQuery-uttryck körs. Den här händelseklassen tillhandahåller den statiska typen av XQuery-uttryck.
`199`	`QN: subscription`	Inträffar när en frågeregistrering inte kan prenumerera. Kolumnen `TextData` innehåller information om händelsen.
`200`	`QN: parameter table`	Information om aktiva prenumerationer lagras i interna parametertabeller. Den här händelseklassen inträffar när en parametertabell skapas eller tas bort. Dessa tabeller skapas eller tas vanligtvis bort när databasen startas om. Kolumnen `TextData` innehåller information om händelsen.
`201`	`QN: template`	En frågemall representerar en klass med prenumerationsfrågor. Vanligtvis är frågor i samma klass identiska förutom deras parametervärden. Den här händelseklassen inträffar när en ny prenumerationsbegäran hamnar i en redan befintlig klass av (`Match`), en ny klass (`Create`) eller en `Drop`-klass, vilket anger rensning av mallar för frågeklasser utan aktiva prenumerationer. Kolumnen `TextData` innehåller information om händelsen.
`202`	`QN: dynamics`	Spårar interna aktiviteter för frågemeddelanden. Kolumnen `TextData` innehåller information om händelsen.
`212`	`Bitmap Warning`	Anger när bitmappsfilter har inaktiverats i en fråga.
`213`	`Database Suspect Data Page`	Anger när en sida läggs till i tabellen `suspect_pages` i `msdb`.
`214`	`CPU threshold exceeded`	Anger när Resource Governor identifierar att en fråga har överskridit cpu-tröskelvärdet (`REQUEST_MAX_CPU_TIME_SEC`).
`215`	`PreConnect:Starting`	Anger när en LOGON-utlösare eller resource governor-klassificerare startar körningen.
`216`	`PreConnect:Completed`	Anger när en LOGON-utlösare eller resource governor-klassificerare slutför körningen.
`217`	`Plan Guide Successful`	Anger att databasmotorn har skapat en körningsplan för en fråga eller batch som innehåller en planguide.
`218`	`Plan Guide Unsuccessful`	Anger att databasmotorn inte kunde skapa en körningsplan för en fråga eller batch som innehöll en planguide. Databasmotorn försökte generera en körningsplan för den här frågan eller batchen utan att använda planguiden. En ogiltig planguide kan vara orsaken till det här problemet. Du kan verifiera planguiden med hjälp av `sys.fn_validate_plan_guide`-systemfunktionen.
`235`	`Audit Fulltext`

[ @columnid = ] columnid

ID:t för kolumnen som ska läggas till för händelsen. @columnid är int, utan standard.

I följande tabell visas de kolumner som kan läggas till för en händelse.

Kolumnnummer	Kolumnnamn	Beskrivning
`1`	`TextData`	Textvärde som är beroende av händelseklassen som samlas in i spårningen.
`2`	`BinaryData`	Binärt värde som är beroende av händelseklassen som samlas in i spårningen.
`3`	`DatabaseID`	ID för databasen som anges av instruktionen USE database eller standarddatabasen om ingen USE -databas-instruktion utfärdas för en viss anslutning. Värdet för en databas kan fastställas med hjälp av funktionen DB_ID.
`4`	`TransactionID`	Systemtilldelat ID för transaktionen.
`5`	`LineNumber`	Innehåller numret på den rad som innehåller felet. För händelser som omfattar Transact-SQL-instruktioner, till exempel `SP:StmtStarting`, innehåller `LineNumber` radnumret för -instruktionen i den lagrade proceduren eller batchen.
`6`	`NTUserName`	Windows-användarnamn.
`7`	`NTDomainName`	Windows-domän som användaren tillhör.
`8`	`HostName`	Namnet på klientdatorn som kom från begäran.
`9`	`ClientProcessID`	ID som tilldelats av klientdatorn till den process där klientprogrammet körs.
`10`	`ApplicationName`	Namnet på klientprogrammet som skapade anslutningen till en instans av SQL Server. Den här kolumnen fylls i med de värden som skickas av programmet i stället för programmets visade namn.
`11`	`LoginName`	SQL Server-inloggningsnamnet för klienten.
`12`	`SPID`	Serverprocess-ID som tilldelats av SQL Server till den process som är associerad med klienten.
`13`	`Duration`	Hur lång tid händelsen tar (i mikrosekunder). Den här datakolumnen fylls inte i av händelsen `Hash Warning`.
`14`	`StartTime`	Tidpunkt då händelsen startade, när den var tillgänglig.
`15`	`EndTime`	Tidpunkt då händelsen avslutades. Den här kolumnen fylls inte i för att starta händelseklasser, till exempel `SQL:BatchStarting` eller `SP:Starting`. Den fylls inte heller i av händelsen `Hash Warning`.
`16`	`Reads`	Antal logiska diskläsningar som utförs av servern för händelsens räkning. Den här kolumnen fylls inte i av händelsen `Lock:Released`.
`17`	`Writes`	Antal fysiska diskskrivningar som utförs av servern för händelsens räkning.
`18`	`CPU`	Mängden CPU-tid (i millisekunder) som används av händelsen.
`19`	`Permissions`	Representerar bitmappen med behörigheter. används av säkerhetsgranskning.
`20`	`Severity`	Allvarlighetsgrad för ett undantag.
`21`	`EventSubClass`	Typ av händelseunderklass. Den här datakolumnen fylls inte i för alla händelseklasser.
`22`	`ObjectID`	Systemtilldelat ID för objektet.
`23`	`Success`	Lyckat användningsförsök för behörigheter. används för granskning. `1` = lyckades `0` = fel
`24`	`IndexID`	ID för indexet för det objekt som påverkas av händelsen. Om du vill fastställa index-ID:t för ett objekt använder du kolumnen `indid` i `sysindexes`-systemtabellen.
`25`	`IntegerData`	Heltalsvärdet är beroende av händelseklassen som samlas in i spårningen.
`26`	`ServerName`	Namnet på instansen av SQL Server, antingen servernamn eller servernamn\instansnamn, som spåras.
`27`	`EventClass`	Typ av händelseklass som registreras.
`28`	`ObjectType`	Typ av objekt, till exempel: tabell, funktion eller lagrad procedur.
`29`	`NestLevel`	Den kapslingsnivå som den här lagrade proceduren körs på. Se @@NESTLEVEL.
`30`	`State`	Servertillstånd om ett fel uppstår.
`31`	`Error`	Felnummer.
`32`	`Mode`	Låsläge för låset som hämtats. Den här kolumnen fylls inte i av händelsen `Lock:Released`.
`33`	`Handle`	Handtag för det objekt som refereras till i händelsen.
`34`	`ObjectName`	Namnet på objektet som används.
`35`	`DatabaseName`	Namnet på databasen som anges i instruktionen USE database.
`36`	`FileName`	Det logiska namnet på det ändrade filnamnet.
`37`	`OwnerName`	Ägarnamn för det refererade objektet.
`38`	`RoleName`	Namnet på databasen eller den serveromfattande roll som en instruktion riktar sig mot.
`39`	`TargetUserName`	Användarnamn för målet för en åtgärd.
`40`	`DBUserName`	SQL Server-databasanvändarnamnet för klienten.
`41`	`LoginSid`	Säkerhetsidentifierare (SID) för den inloggade användaren.
`42`	`TargetLoginName`	Inloggningsnamn för målet för en åtgärd.
`43`	`TargetLoginSid`	SID för inloggningen som är målet för någon åtgärd.
`44`	`ColumnPermissions`	Behörighetsstatus på kolumnnivå; används av säkerhetsgranskning.
`45`	`LinkedServerName`	Namnet på den länkade servern.
`46`	`ProviderName`	Namnet på OLE DB-providern.
`47`	`MethodName`	Namnet på OLE DB-metoden.
`48`	`RowCounts`	Antal rader i batchen.
`49`	`RequestID`	ID för begäran som innehåller -instruktionen.
`50`	`XactSequence`	En token som beskriver den aktuella transaktionen.
`51`	`EventSequence`	Sekvensnummer för den här händelsen.
`52`	`BigintData1`	bigint- värde, som är beroende av händelseklassen som samlas in i spårningen.
`53`	`BigintData2`	bigint- värde, som är beroende av händelseklassen som samlas in i spårningen.
`54`	`GUID`	GUID-värde, som är beroende av händelseklassen som samlas in i spårningen.
`55`	`IntegerData2`	Heltalsvärde, som är beroende av händelseklassen som samlas in i spårningen.
`56`	`ObjectID2`	ID för det relaterade objektet eller entiteten, om det är tillgängligt.
`57`	`Type`	Heltalsvärde, som är beroende av händelseklassen som samlas in i spårningen.
`58`	`OwnerID`	Typ av objekt som äger låset. Endast för låshändelser.
`59`	`ParentName`	Namnet på schemat som objektet finns i.
`60`	`IsSystem`	Anger om händelsen inträffade i en systemprocess eller en användarprocess. `1` = system `0` = användare.
`61`	`Offset`	Startförskjutning av -instruktionen i den lagrade proceduren eller batchen.
`62`	`SourceDatabaseID`	ID för databasen där objektets källa finns.
`63`	`SqlHandle`	64-bitars hash baserat på texten i en ad hoc-fråga eller databasen och objekt-ID:t för ett SQL-objekt. Det här värdet kan skickas till `sys.dm_exec_sql_text()` för att hämta den associerade SQL-texten.
`64`	`SessionLoginName`	Inloggningsnamnet för den användare som påbörjade sessionen. Om du till exempel ansluter till SQL Server med `Login1` och kör en instruktion som `Login2`visar `SessionLoginNameLogin1`medan `LoginName` visar `Login2`. Den här datakolumnen visar både SQL Server- och Windows-inloggningar.

[ @on = ] på

Anger om händelsen ska aktiveras (1) eller inaktiveras (0). @on är bit, utan standard.

Om @on är inställt på 1, och @columnid är NULL, är händelsen inställd på ON och alla kolumner rensas. Om @columnid inte är null anges kolumnen till PÅ för den händelsen.

Om @on är inställt på 0, och @columnid är NULL, aktiveras händelsen OFF och alla kolumner rensas. Om @columnid inte är null inaktiveras kolumnen.

Den här tabellen illustrerar interaktionen mellan @on och @columnid.

@on	@columnid	Resultat
PÅ (`1`)	`NULL`	Händelsen aktiveras på. Alla kolumner rensas.
	`NOT NULL`	Kolumnen aktiveras på för den angivna händelsen.
AV (`0`)	`NULL`	Händelsen har inaktiverats . Alla kolumner rensas.
	`NOT NULL`	Kolumnen inaktiveras för den angivna händelsen.

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.
`2`	Spårningen körs för närvarande. Om du ändrar spårningen just nu resulterar det i ett fel.
`3`	Den angivna händelsen är inte giltig. Händelsen kanske inte finns eller så är den inte lämplig för butiksproceduren.
`4`	Den angivna kolumnen är inte giltig.
`9`	Det angivna spårningshandtaget är inte giltigt.
`11`	Den angivna kolumnen används internt och kan inte tas bort.
`13`	Slut på minne. Returneras när det inte finns tillräckligt med minne för att utföra den angivna åtgärden.
`16`	Funktionen är inte giltig för den här spårningen.

Anmärkningar

sp_trace_setevent utför många av de åtgärder som tidigare utfördes av utökade lagrade procedurer som är tillgängliga i tidigare versioner av SQL Server. Använd sp_trace_setevent i stället för:

xp_trace_addnewqueue
xp_trace_eventclassrequired
xp_trace_seteventclassrequired

Användare måste köra sp_trace_setevent för varje kolumn som läggs till för varje händelse. Om @on är inställt på 1lägger sp_trace_setevent till den angivna händelsen i listan över händelser i spårningen under varje körning. Om @on är inställt på 0tar sp_trace_setevent bort den angivna händelsen från listan.

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