Sdílet prostřednictvím


sp_trace_setevent (Transact-SQL)

platí pro:SQL Server

Přidá nebo odebere do trasování sloupec události nebo události. sp_trace_setevent lze spustit pouze u existujících tras, které jsou zastaveny (@status je 0). Pokud se tato uložená procedura spustí na trasování, které neexistuje nebo je @status není 0.

Důležitý

Tato funkce bude odebrána v budoucí verzi SQL Serveru. Nepoužívejte tuto funkci v nové vývojové práci a naplánujte úpravu aplikací, které tuto funkci aktuálně používají. Místo toho použijte rozšířené události.

Transact-SQL konvence syntaxe

Syntax

sp_trace_setevent
    [ @traceid = ] traceid
    , [ @eventid = ] eventid
    , [ @columnid = ] columnid
    , [ @on = ] on
[ ; ]

Argumenty

Důležitý

Argumenty rozšířených uložených procedur musí být zadány v určitém pořadí, jak je popsáno v části Syntaxe. Pokud jsou parametry zadány mimo pořadí, dojde k chybové zprávě.

[ @traceid = ] traceid

ID trasování, které se má upravit. @traceid je int, bez výchozího nastavení. Uživatel používá tuto @traceid hodnotu k identifikaci, úpravě a řízení trasování.

[ @eventid = ] id události

ID události, která se má zapnout. @eventid je , bez výchozího nastavení.

Tato tabulka uvádí události, které lze přidat nebo odebrat z trasování.

Číslo události Název události Popis
0 na 9 Reserved Rezervovaný
10 RPC:Completed Nastane při dokončení vzdáleného volání procedur (RPC).
11 RPC:Starting Nastane při spuštění RPC.
12 SQL:BatchCompleted Nastane po dokončení Transact-SQL dávky.
13 SQL:BatchStarting Nastane, když se spustí Transact-SQL dávka.
14 Audit Login Nastane, když se uživatel úspěšně přihlásí k SQL Serveru.
15 Audit Logout Nastane, když se uživatel odhlásí z SQL Serveru.
16 Attention Nastane, když dojde k událostem pozornosti, jako jsou požadavky na přerušení klienta nebo přerušená připojení klientů.
17 ExistingConnection Detekuje všechny aktivity uživatelů připojených k SQL Serveru před spuštěním trasování.
18 Audit Server Starts and Stops Nastane při změně stavu služby SQL Serveru.
19 DTCTransaction Sleduje koordinované transakce ms DTC (Microsoft Distributed Transaction Coordinator) mezi dvěma nebo více databázemi.
20 Audit Login Failed Označuje, že pokus o přihlášení k SQL Serveru z klienta selhal.
21 EventLog Označuje, že události byly zaznamenány v protokolu aplikace systému Windows.
22 ErrorLog Označuje, že události chyb byly zaznamenány v protokolu chyb SQL Serveru.
23 Lock:Released Označuje, že byl vydán zámek prostředku, například stránky.
24 Lock:Acquired Označuje pořízení zámku prostředku, například datovou stránku.
25 Lock:Deadlock Označuje, že dvě souběžné transakce mají vzájemné vzájemné zablokování tím, že se pokusí získat nekompatibilní zámky na prostředcích, které druhá transakce vlastní.
26 Lock:Cancel Označuje, že získání zámku prostředku bylo zrušeno (například kvůli vzájemnému zablokování).
27 Lock:Timeout Označuje, že vypršel časový limit požadavku na zámek prostředku, jako je stránka, kvůli jiné transakci, která obsahuje blokující zámek požadovaného prostředku. Časový limit je určen funkcí @@LOCK_TIMEOUT a lze ho nastavit pomocí příkazu SET LOCK_TIMEOUT.
28 Degree of Parallelism Event Nastane před spuštěním příkazu SELECT, INSERT nebo UPDATE.
29 na 31 Reserved Místo toho použijte událost 28.
32 Reserved Rezervovaný
33 Exception Označuje, že na SQL Serveru došlo k výjimce.
34 SP:CacheMiss Označuje, kdy uložená procedura není v mezipaměti procedur nalezena.
35 SP:CacheInsert Označuje, kdy je položka vložena do mezipaměti procedur.
36 SP:CacheRemove Označuje, kdy je položka odebrána z mezipaměti procedur.
37 SP:Recompile Označuje, že uložená procedura byla rekompilována.
38 SP:CacheHit Označuje, kdy se uložená procedura nachází v mezipaměti procedur.
39 Deprecated Zavrhovaný
40 SQL:StmtStarting Nastane při spuštění příkazu Transact-SQL.
41 SQL:StmtCompleted Nastane po dokončení příkazu Transact-SQL.
42 SP:Starting Označuje, kdy se uložená procedura spustila.
43 SP:Completed Označuje, kdy se uložená procedura dokončila.
44 SP:StmtStarting Označuje, že se spustil příkaz Transact-SQL v rámci uložené procedury.
45 SP:StmtCompleted Označuje, že spuštění příkazu Transact-SQL v rámci uložené procedury bylo dokončeno.
46 Object:Created Označuje, že byl vytvořen objekt, například pro příkazy CREATE INDEX, CREATE TABLE a CREATE DATABASE.
47 Object:Deleted Označuje, že objekt byl odstraněn, například v příkazech DROP INDEX a DROP TABLE.
48 Reserved
49 Reserved
50 SQL Transaction Sleduje Transact-SQL příkazy BEGIN, COMMIT, SAVE a ROLLBACK TRANSACTION.
51 Scan:Started Označuje, kdy se spustila kontrola tabulky nebo indexu.
52 Scan:Stopped Označuje, kdy se zastavila kontrola tabulky nebo indexu.
53 CursorOpen Označuje, kdy je kurzor otevřen na Transact-SQL příkazu ODBC, OLE DB nebo DB-Library.
54 TransactionLog Sleduje, kdy se transakce zapisují do transakčního protokolu.
55 Hash Warning Označuje, že operace hashování (například spojení hash, agregace hash, sjednocení hodnot hash a jedinečné hodnoty hash), která se nezpracovává v oddílu vyrovnávací paměti, se vrátila k alternativnímu plánu. K tomu může dojít z důvodu rekurzivní hloubky, nerovnoměrné distribuce dat, příznaků trasování nebo počítání bitů.
56 na 57 Reserved
58 Auto Stats Označuje, že došlo k automatické aktualizaci statistik indexu.
59 Lock:Deadlock Chain Vytvořeno pro každou událost vedoucí k vzájemnému zablokování.
60 Lock:Escalation Označuje, že jemně odstupňovaný zámek byl převeden na hrubší odstupňovaný zámek (například zámek stránky eskalován nebo převeden na zámek TABLE nebo HoBT).
61 OLE DB Errors Označuje, že došlo k chybě OLE DB.
62 na 66 Reserved
67 Execution Warnings Označuje všechna upozornění, ke kterým došlo během provádění příkazu SQL Serveru nebo uložené procedury.
68 Showplan Text (Unencoded) Zobrazí strom plánu spuštěného příkazu Transact-SQL.
69 Sort Warnings Označuje operace řazení, které se nevejdou do paměti. Nezahrnuje operace řazení zahrnující vytváření indexů; pouze operace řazení v dotazu (například klauzule ORDER BY použitá v příkazu SELECT).
70 CursorPrepare Označuje, kdy je kurzor na příkazu Transact-SQL připravený pro použití rozhraní ODBC, OLE DB nebo knihovny DB.
71 Prepare SQL ROZHRANÍ ODBC, OLE DB nebo DB-Library připravilo Transact-SQL příkaz nebo příkazy pro použití.
72 Exec Prepared SQL Rozhraní ODBC, OLE DB nebo DB-Library spustilo připravený příkaz nebo příkazy Transact-SQL.
73 Unprepare SQL Rozhraní ODBC, OLE DB nebo DB-Library nemá připravený (odstraněný) připravený příkaz nebo příkazy Transact-SQL.
74 CursorExecute Kurzor dříve připravený na příkaz Transact-SQL rozhraní ODBC, OLE DB nebo DB-Library se spustí.
75 CursorRecompile Kurzor otevřený na příkazu Transact-SQL rozhraním ODBC nebo DB-Library byl rekompilován přímo nebo kvůli změně schématu.

Aktivuje se pro kurzory ANSI a jiné než ANSI.
76 CursorImplicitConversion Kurzor na příkaz Transact-SQL je převeden SQL Serverem z jednoho typu na jiný.

Aktivuje se pro kurzory ANSI a jiné než ANSI.
77 CursorUnprepare Připravený kurzor na příkaz Transact-SQL není připravený (odstraněný) rozhraním ODBC, OLE DB nebo knihovnou DB.
78 CursorClose Kurzor dříve otevřený v příkazu Transact-SQL rozhraní ODBC, OLE DB nebo DB-Library je zavřený.
79 Missing Column Statistics Statistiky sloupců, které mohly být užitečné pro optimalizátor, nejsou k dispozici.
80 Missing Join Predicate Dotaz, který není predikát spojení, se spouští. Výsledkem může být dlouhotrvající dotaz.
81 Server Memory Change Využití paměti SQL Serveru se zvýšilo nebo snížilo o 1 megabajt (MB) nebo o 5 procent maximální paměti serveru podle toho, co je větší.
82 na 91 User Configurable (0 - 9) Data událostí definovaná uživatelem
92 Data File Auto Grow Označuje, že server automaticky rozšířil datový soubor.
93 Log File Auto Grow Označuje, že server automaticky rozšířil soubor protokolu.
94 Data File Auto Shrink Označuje, že server automaticky změkl datový soubor.
95 Log File Auto Shrink Označuje, že server automaticky změkl soubor protokolu.
96 Showplan Text Zobrazí strom plánu dotazu příkazu SQL z optimalizátoru dotazů. Sloupec TextData neobsahuje plán Showplan pro tuto událost.
97 Showplan All Zobrazí plán dotazu s úplnými podrobnostmi o kompilaci příkazu SQL. Sloupec TextData neobsahuje plán Showplan pro tuto událost.
98 Showplan Statistics Profile Zobrazí plán dotazu s úplnými podrobnostmi o spuštění příkazu SQL. Sloupec TextData neobsahuje plán Showplan pro tuto událost.
99 Reserved
100 RPC Output Parameter Vytvoří výstupní hodnoty parametrů pro každý RPC.
101 Reserved
102 Audit Database Scope GDR Vyvolá se pokaždé, když uživatel SQL Serveru vydá oprávnění GRANT, DENY, REVOKE pro příkazové oprávnění, například udělení oprávnění k databázi.
103 Audit Object GDR Event Nastane pokaždé, když uživatel SQL Serveru vydá oprávnění GRANT, DENY, REVOKE pro objekt.
104 Audit AddLogin Event Nastane při přidání nebo odebrání přihlášení k SQL Serveru; pro sp_addlogin a sp_droplogin.
105 Audit Login GDR Event Nastane při přidání nebo odebrání přihlašovacího práva systému Windows; pro sp_grantlogin, sp_revokelogina sp_denylogin.
106 Audit Login Change Property Event Nastane, když se změní vlastnost přihlášení s výjimkou hesel; pro sp_defaultdb a sp_defaultlanguage.
107 Audit Login Change Password Event Nastane při změně přihlašovacího hesla SQL Serveru.

Hesla se nezaznamenají.
108 Audit Add Login to Server Role Event Nastane při přidání nebo odebrání přihlášení z pevné role serveru; pro sp_addsrvrolemembera sp_dropsrvrolemember.
109 Audit Add DB User Event Nastane při přidání nebo odebrání přihlášení jako uživatel databáze (Windows nebo SQL Server) do databáze; pro sp_grantdbaccess, sp_revokedbaccess, sp_addusera sp_dropuser.
110 Audit Add Member to DB Role Event Nastane při přidání nebo odebrání přihlášení jako uživatel databáze (pevné nebo uživatelem definované) do databáze; pro sp_addrolemember, sp_droprolemembera sp_changegroup.
111 Audit Add Role Event Nastane při přidání nebo odebrání přihlášení jako uživatel databáze do databáze; pro sp_addrole a sp_droprole.
112 Audit App Role Change Password Event Nastane při změně hesla role aplikace.
113 Audit Statement Permission Event Nastane, když se použije oprávnění k příkazu (například CREATE TABLE).
114 Audit Schema Object Access Event Nastane, když se použije oprávnění objektu (například SELECT), a to jak úspěšně, tak neúspěšně.
115 Audit Backup/Restore Event Nastane při vydání příkazu BACKUP nebo RESTORE.
116 Audit DBCC Event Nastane, když jsou vydány příkazy DBCC.
117 Audit Change Audit Event Nastane při provádění změn trasování auditu.
118 Audit Object Derived Permission Event Nastane, když jsou vydány příkazy CREATE, ALTER a DROP objektu.
119 OLEDB Call Event Nastane, když se volání zprostředkovatele OLE DB provádí pro distribuované dotazy a vzdálené uložené procedury.
120 OLEDB QueryInterface Event Nastane, když ole DB QueryInterface volání jsou provedena pro distribuované dotazy a vzdálené uložené procedury.
121 OLEDB DataRead Event Nastane při volání žádosti o data pro zprostředkovatele OLE DB.
122 Showplan XML Nastane při spuštění příkazu SQL. Zahrňte tuto událost k identifikaci operátorů Showplan. Každá událost je uložena v dobře vytvořeném dokumentu XML. Sloupec Binary pro tuto událost obsahuje kódovaný plán Showplan. Pomocí SQL Server Profileru otevřete trasování a zobrazte plán showplan.
123 SQL:FullTextQuery Nastane, když se spustí fulltextový dotaz.
124 Broker:Conversation Zaznamenává průběh konverzace služby Service Broker.
125 Deprecation Announcement Nastane, když použijete funkci, která bude odebrána z budoucí verze SQL Serveru.
126 Deprecation Final Support Nastane, když použijete funkci, která bude odebrána z příští hlavní verze SQL Serveru.
127 Exchange Spill Event Nastane, když jsou komunikační vyrovnávací paměti v plánu paralelních dotazů dočasně zapsány do tempdb databáze.
128 Audit Database Management Event Nastane při vytvoření, změně nebo vyřazení databáze.
129 Audit Database Object Management Event Nastane, když příkaz CREATE, ALTER nebo DROP provede u databázových objektů, jako jsou schémata.
130 Audit Database Principal Management Event Nastane, když se objekty zabezpečení, jako jsou uživatelé, vytvoří, změní nebo zahodí z databáze.
131 Audit Schema Object Management Event Nastane, když se vytvoří, změní nebo zahodí objekty serveru.
132 Audit Server Principal Impersonation Event Nastane, když v oboru serveru existuje zosobnění, například EXECUTE AS LOGIN.
133 Audit Database Principal Impersonation Event Nastane, když dojde k zosobnění v rámci oboru databáze, například EXECUTE AS USER nebo SETUSER.
134 Audit Server Object Take Ownership Event Nastane, když je vlastník změněn pro objekty v oboru serveru.
135 Audit Database Object Take Ownership Event Nastane, když dojde ke změně vlastníka objektů v oboru databáze.
136 Broker:Conversation Group Nastane, když Service Broker vytvoří novou skupinu konverzací nebo zahodí existující skupinu konverzací.
137 Blocked Process Report Nastane, když je proces blokovaný déle než zadanou dobu. Nezahrnuje systémové procesy ani procesy, které čekají na neblokovatelné prostředky. Pomocí sp_configure můžete nakonfigurovat prahovou hodnotu a frekvenci generování sestav.
138 Broker:Connection Hlásí stav přenosového připojení spravovaného nástrojem Service Broker.
139 Broker:Forwarded Message Sent Nastane, když Service Broker přeposílá zprávu.
140 Broker:Forwarded Message Dropped Nastane, když Service Broker zahodí zprávu, která měla být přeposlána.
141 Broker:Message Classify Nastane, když Service Broker určuje směrování pro zprávu.
142 Broker:Transmission Označuje, že došlo k chybám v přenosové vrstvě služby Service Broker. Číslo chyby a hodnoty stavu označují zdroj chyby.
143 Broker:Queue Disabled Označuje, že byla zjištěna otrávená zpráva, protože ve frontě Service Broker došlo k pěti po sobě jdoucím vrácení transakcí zpět. Událost obsahuje ID databáze a ID fronty fronty, která obsahuje zprávu o jedu.
144 na 145 Reserved
146 Showplan XML Statistics Profile Nastane při spuštění příkazu SQL. Identifikuje operátory Showplan a zobrazí úplná data o čase kompilace. Sloupec Binary pro tuto událost obsahuje kódovaný plán Showplan. Pomocí SQL Server Profileru otevřete trasování a zobrazte plán showplan.
148 Deadlock Graph Nastane, když pokus o získání zámku je zrušen, protože pokus byl součástí zablokování a byl vybrán jako oběť vzájemného zablokování. Poskytuje popis xml zablokování.
149 Broker:Remote Message Acknowledgement Nastane, když Service Broker odešle nebo přijme potvrzení zprávy.
150 Trace File Close Nastane, když se trasovací soubor zavře během přechodu trasovacího souboru.
151 Reserved
152 Audit Change Database Owner Nastane, když se k změně vlastníka databáze a oprávnění použije funkce ALTER AUTHORIZATION, která k tomu slouží.
153 Audit Schema Object Take Ownership Event Nastane, když se alter AUTHORIZATION používá k přiřazení vlastníka k objektu a oprávnění jsou zaškrtnuta k tomu.
154 Reserved
155 FT:Crawl Started Nastane při spuštění fulltextového procházení (populace). Slouží ke kontrole, jestli je žádost o procházení vyzvednuta pracovními úkoly.
156 FT:Crawl Stopped Nastane, když se zastaví procházení fulltextu (základní soubor). Zastaví se, když se procházení úspěšně dokončí nebo když dojde k závažné chybě.
157 FT:Crawl Aborted Nastane, když během procházení fulltextu dojde k výjimce. Obvykle způsobí zastavení fulltextového procházení.
158 Audit Broker Conversation Zaznamenává zprávy auditu související se zabezpečením dialogového okna Service Broker.
159 Audit Broker Login Zaznamenává zprávy auditu související se zabezpečením přenosu služby Service Broker.
160 Broker:Message Undeliverable Nastane, když Service Broker nemůže zachovat přijatou zprávu, která by měla být doručena do služby.
161 Broker:Corrupted Message Nastane, když Service Broker obdrží poškozenou zprávu.
162 User Error Message Zobrazí chybové zprávy, které se uživatelům zobrazí v případě chyby nebo výjimky.
163 Broker:Activation Nastane, když monitorování fronty spustí aktivační uloženou proceduru, odešle QUEUE_ACTIVATION oznámení nebo když aktivace uložená procedura spuštěná monitorováním fronty ukončí.
164 Object:Altered Nastane při změně databázového objektu.
165 Performance statistics Nastane, když se zkompilovaný plán dotazu poprvé ukládá do mezipaměti, rekompiluje nebo odebere z mezipaměti plánu.
166 SQL:StmtRecompile Nastane, když dojde k rekompilace na úrovni příkazu.
167 Database Mirroring State Change Nastane, když se změní stav zrcadlené databáze.
168 Showplan XML For Query Compile Nastane při kompilaci příkazu SQL. Zobrazí kompletní data v době kompilace. Sloupec Binary pro tuto událost obsahuje kódovaný plán Showplan. Pomocí SQL Server Profileru otevřete trasování a zobrazte plán showplan.
169 Showplan All For Query Compile Nastane při kompilaci příkazu SQL. Zobrazí dokončená data v době kompilace. Slouží k identifikaci operátorů Showplan.
170 Audit Server Scope GDR Event Označuje, že došlo k události udělení, zamítnutí nebo odvolání oprávnění v oboru serveru, například vytvoření přihlášení.
171 Audit Server Object GDR Event Označuje, že došlo k události udělení, zamítnutí nebo odvolání objektu schématu, například tabulky nebo funkce.
172 Audit Database Object GDR Event Označuje, že došlo k události udělení, zamítnutí nebo odvolání přístupu databázových objektů, jako jsou sestavení a schémata.
173 Audit Server Operation Event Nastane, když se použijí operace auditu zabezpečení, jako je změna nastavení, prostředky, externí přístup nebo autorizace.
175 Audit Server Alter Trace Event Nastane, když příkaz zkontroluje oprávnění ALTER TRACE.
176 Audit Server Object Management Event Nastane, když se vytvoří, změní nebo zahodí objekty serveru.
177 Audit Server Principal Management Event Nastane, když se vytvoří, změní nebo zahodí objekty zabezpečení serveru.
178 Audit Database Operation Event Nastane, když dojde k databázovým operacím, jako je kontrolní bod nebo oznámení dotazu přihlášení k odběru.
180 Audit Database Object Access Event Nastane, když se k databázovým objektům, jako jsou schémata, přistupuje.
181 TM: Begin Tran starting Nastane při spuštění požadavku BEGIN TRANSACTION.
182 TM: Begin Tran completed Nastane, když se dokončí BEGIN TRANSACTION požadavek.
183 TM: Promote Tran starting Nastane při spuštění požadavku PROMOTE TRANSACTION.
184 TM: Promote Tran completed Nastane, když se dokončí PROMOTE TRANSACTION požadavek.
185 TM: Commit Tran starting Nastane při spuštění požadavku COMMIT TRANSACTION.
186 TM: Commit Tran completed Nastane, když se dokončí COMMIT TRANSACTION požadavek.
187 TM: Rollback Tran starting Nastane při spuštění požadavku ROLLBACK TRANSACTION.
188 TM: Rollback Tran completed Nastane, když se dokončí ROLLBACK TRANSACTION požadavek.
189 Lock:Timeout (timeout > 0) Nastane, když vyprší časový limit požadavku na uzamčení prostředku, například stránky.
190 Progress Report: Online Index Operation Zaznamenává průběh operace sestavení online indexu, když je proces sestavení spuštěný.
191 TM: Save Tran starting Nastane při spuštění požadavku SAVE TRANSACTION.
192 TM: Save Tran completed Nastane, když se dokončí SAVE TRANSACTION požadavek.
193 Background Job Error Nastane, když úloha na pozadí skončí neobvykle.
194 OLEDB Provider Information Nastane, když se distribuovaný dotaz spustí a shromažďuje informace odpovídající připojení zprostředkovatele.
195 Mount Tape Nastane při přijetí žádosti o připojení pásky.
196 Assembly Load Nastane, když dojde k požadavku na načtení sestavení CLR.
197 Reserved
198 XQuery Static Type Vyvolá se při spuštění výrazu XQuery. Tato třída událostí poskytuje statický typ výrazu XQuery.
199 QN: subscription Nastane, když se registrace dotazu nedá přihlásit k odběru. Sloupec TextData obsahuje informace o události.
200 QN: parameter table Informace o aktivních předplatných jsou uloženy v interních tabulkách parametrů. Tato třída události nastane při vytvoření nebo odstranění tabulky parametrů. Tyto tabulky se obvykle vytvářejí nebo odstraňují při restartování databáze. Sloupec TextData obsahuje informace o události.
201 QN: template Šablona dotazu představuje třídu dotazů předplatného. Dotazy ve stejné třídě jsou obvykle shodné s výjimkou jejich hodnot parametrů. K této třídě události dochází, když nová žádost o odběr spadá do již existující třídy (Match), nové třídy (Create) nebo třídy Drop, která označuje vyčištění šablon pro třídy dotazů bez aktivních odběrů. Sloupec TextData obsahuje informace o události.
202 QN: dynamics Sleduje interní aktivity oznámení dotazů. Sloupec TextData obsahuje informace o události.
212 Bitmap Warning Označuje, kdy byly v dotazu zakázány rastrové filtry.
213 Database Suspect Data Page Označuje, kdy je stránka přidána do tabulky suspect_pages v msdb.
214 CPU threshold exceeded Označuje, kdy správce prostředků zjistí, že dotaz překročil prahovou hodnotu procesoru (REQUEST_MAX_CPU_TIME_SEC).
215 PreConnect:Starting Označuje, kdy trigger LOGON nebo funkce klasifikátoru prostředků spustí provádění.
216 PreConnect:Completed Označuje, kdy trigger LOGON nebo funkce klasifikátoru prostředků dokončí provádění.
217 Plan Guide Successful Označuje, že databázový stroj úspěšně vytvořil plán provádění pro dotaz nebo dávku, která obsahovala průvodce plánem.
218 Plan Guide Unsuccessful Označuje, že databázový stroj nemohl vytvořit plán provádění pro dotaz nebo dávku, která obsahovala průvodce plánem. Databázový stroj se pokusil vygenerovat plán provádění pro tento dotaz nebo dávku bez použití průvodce plánem. Příčinou tohoto problému může být neplatný průvodce plánem. Průvodce plánem můžete ověřit pomocí systémové funkce sys.fn_validate_plan_guide.
235 Audit Fulltext

[ @columnid = ] columnid

ID sloupce, který se má přidat pro událost. @columnid je , bez výchozího nastavení.

Následující tabulka uvádí sloupce, které lze přidat pro událost.

Číslo sloupce Název sloupce Popis
1 TextData Textová hodnota závislá na třídě události zachycené v trasování.
2 BinaryData Binární hodnota závislá na třídě události zachycené v trasování.
3 DatabaseID ID databáze určené příkazem databáze USE nebo výchozí databáze, pokud pro dané připojení není vydán žádný příkaz USE databáze.

Hodnotu databáze lze určit pomocí funkce DB_ID.
4 TransactionID ID transakce přiřazené systémem.
5 LineNumber Obsahuje číslo řádku, který obsahuje chybu. U událostí, které zahrnují příkazy Transact-SQL, například SP:StmtStarting, obsahuje LineNumber číslo řádku příkazu v uložené proceduře nebo dávce.
6 NTUserName Uživatelské jméno systému Windows.
7 NTDomainName Doména Systému Windows, do které uživatel patří.
8 HostName Název klientského počítače, který žádost pochází.
9 ClientProcessID ID přiřazené klientským počítačem procesu, ve kterém je klientská aplikace spuštěná.
10 ApplicationName Název klientské aplikace, která vytvořila připojení k instanci SQL Serveru. Tento sloupec se naplní hodnotami předanými aplikací místo zobrazovaného názvu programu.
11 LoginName Přihlašovací jméno klienta systému SQL Server.
12 SPID ID procesu serveru přiřazené SQL Serverem k procesu přidruženému k klientovi.
13 Duration Doba trvání události (v mikrosekundách). Tento datový sloupec není naplněn událostí Hash Warning.
14 StartTime Čas, kdy událost začala, pokud je k dispozici.
15 EndTime Čas, kdy událost skončila. Tento sloupec není naplněn pro spouštění tříd událostí, jako jsou SQL:BatchStarting nebo SP:Starting. Událost Hash Warning také nezaplní.
16 Reads Počet čtení logických disků provedených serverem jménem události Tento sloupec není naplněn událostí Lock:Released.
17 Writes Počet zápisů fyzických disků provedených serverem jménem události
18 CPU Doba procesoru (v milisekundách) používaná událostí
19 Permissions Představuje rastrový obrázek oprávnění; používá se auditováním zabezpečení.
20 Severity Úroveň závažnosti výjimky
21 EventSubClass Typ podtřídy události Tento datový sloupec není vyplněný pro všechny třídy událostí.
22 ObjectID ID objektu přiřazené systémem.
23 Success Úspěch pokusu o použití oprávnění; používá se k auditování.

1 = úspěch
0 = selhání
24 IndexID ID indexu objektu ovlivněného událostí. K určení ID indexu objektu použijte sloupec indid systémové tabulky sysindexes.
25 IntegerData Celočíselná hodnota závislá na třídě události zachycené v trasování.
26 ServerName Název instance SQL Serveru, název serveru nebo název_instance\název_instance, který je trasován.
27 EventClass Typ třídy událostí, která se zaznamenává.
28 ObjectType Typ objektu, například: tabulka, funkce nebo uložená procedura.
29 NestLevel Úroveň vnoření, na které se tato uložená procedura spouští. Viz @@NESTLEVEL.
30 State Stav serveru v případě chyby
31 Error Číslo chyby.
32 Mode Režim uzamčení získaného zámku Tento sloupec není naplněn událostí Lock:Released.
33 Handle Popisovač objektu odkazovaného v události.
34 ObjectName Názevobjektho
35 DatabaseName Název databáze zadané v příkazu USE databáze.
36 FileName Logický název upraveného názvu souboru.
37 OwnerName Jméno vlastníka odkazovaného objektu.
38 RoleName Název databáze nebo role pro celý server, na kterou cílí příkaz.
39 TargetUserName Uživatelské jméno cíle určité akce.
40 DBUserName Uživatelské jméno klienta databáze SQL Serveru
41 LoginSid Identifikátor zabezpečení (SID) přihlášeného uživatele.
42 TargetLoginName Přihlašovací jméno cíle určité akce.
43 TargetLoginSid IDENTIFIKÁTOR SID přihlášení, které je cílem určité akce.
44 ColumnPermissions Stav oprávnění na úrovni sloupce; používá se auditováním zabezpečení.
45 LinkedServerName Název propojeného serveru.
46 ProviderName Název zprostředkovatele OLE DB.
47 MethodName Název metody OLE DB.
48 RowCounts Počet řádků v dávce
49 RequestID ID požadavku obsahujícího příkaz.
50 XactSequence Token pro popis aktuální transakce.
51 EventSequence Pořadové číslo pro tuto událost
52 BigintData1 bigint hodnotu, která je závislá na třídě události zachycené v trasování.
53 BigintData2 bigint hodnotu, která je závislá na třídě události zachycené v trasování.
54 GUID Hodnota GUID, která je závislá na třídě události zachycené v trasování.
55 IntegerData2 Celočíselná hodnota, která je závislá na třídě události zachycené v trasování.
56 ObjectID2 ID souvisejícího objektu nebo entity, pokud je k dispozici.
57 Type Celočíselná hodnota, která je závislá na třídě události zachycené v trasování.
58 OwnerID Typ objektu, který vlastní zámek. Pouze pro události uzamčení.
59 ParentName Název schématu, ve které je objekt.
60 IsSystem Určuje, jestli došlo k události v systémovém procesu nebo uživatelském procesu.

1 = systém
0 = uživatel.
61 Offset Počáteční posun příkazu v rámci uložené procedury nebo dávky
62 SourceDatabaseID ID databáze, ve které existuje zdroj objektu.
63 SqlHandle 64bitová hodnota hash založená na textu ad hoc dotazu nebo databáze a ID objektu objektu SQL. Tuto hodnotu lze předat sys.dm_exec_sql_text() pro načtení přidruženého textu SQL.
64 SessionLoginName Přihlašovací jméno uživatele, který relaci pochází. Pokud se například připojíte k SQL Serveru pomocí Login1 a spustíte příkaz jako Login2, SessionLoginName zobrazí Login1, zatímco LoginName zobrazí Login2. Tento datový sloupec zobrazuje přihlášení SQL Serveru i Windows.

[ @on = ]

Určuje, jestli událost povolí (1) nebo zakáže (0). @on je bit, bez výchozího nastavení.

Pokud je @on nastavená na 1a @columnid je NULL, událost se nastaví na ON a všechny sloupce se vymažou. Pokud @columnid nemá hodnotu null, sloupec je pro tuto událost nastaven na HODNOTU ON.

Pokud je @on nastavená na 0a @columnid je NULL, událost se otočí OFF a všechny sloupce se vymažou. Pokud @columnid není null, sloupec je vypnutý.

Tato tabulka znázorňuje interakci mezi @on a @columnid.

@on @columnid Výsledek
ON (1) NULL Událost je zapnuta na.

Všechny sloupce jsou vymazány.
NOT NULL Sloupec je pro zadanou událost zapnutý.
OFF (0) NULL Událost je vypnuta .

Všechny sloupce jsou vymazány.
NOT NULL Sloupec je pro zadanou událost vypnutý.

Návratové hodnoty kódu

Následující tabulka popisuje hodnoty kódu, které můžete získat po dokončení uložené procedury.

Návratový kód Popis
0 Žádná chyba.
1 Neznámá chyba.
2 Trasování je aktuálně spuštěné. Změna trasování v tuto chvíli způsobí chybu.
3 Zadaná událost není platná. Událost nemusí existovat nebo není vhodná pro proceduru úložiště.
4 Zadaný sloupec není platný.
9 Zadaný popisovač trasování není platný.
11 Zadaný sloupec se používá interně a nedá se odebrat.
13 Nedostatek paměti. Vráceno, pokud není dostatek paměti k provedení zadané akce.
16 Funkce není pro toto trasování platná.

Poznámky

sp_trace_setevent provádí řadu akcí, které byly dříve provedeny rozšířenými uloženými procedurami dostupnými v dřívějších verzích SQL Serveru. Místo těchto sp_trace_setevent použijte:

  • xp_trace_addnewqueue
  • xp_trace_eventclassrequired
  • xp_trace_seteventclassrequired

Uživatelé musí spustit sp_trace_setevent pro každý sloupec přidaný pro každou událost. Při každém spuštění, pokud je @on nastavena na 1, sp_trace_setevent přidá zadanou událost do seznamu událostí trasování. Pokud je @on nastavena na 0, sp_trace_setevent odebere zadanou událost ze seznamu.

Parametry všech uložených procedur sql Trace (sp_trace_*) jsou výhradně zadané. Pokud tyto parametry nejsou volána se správnými datovými typy vstupních parametrů, jak je uvedeno v popisu argumentu, uložená procedura vrátí chybu.

Příklad použití uložených procedur trasování najdete v tématu Vytvořenítrasování .

Dovolení

Vyžaduje oprávnění ALTER TRACE.

  • sys.fn_trace_geteventinfo (Transact-SQL)
  • sys.fn_trace_getinfo (Transact-SQL)
  • sp_trace_generateevent (Transact-SQL)
  • referenční třídy událostí SQL Serveru
  • trasování SQL