sp_trace_setevent (Transact-SQL)

Статья
12/15/2008

Изменения: 12 декабря 2006 г.

Добавляет к трассировке или удаляет из нее событие либо столбец событий. Хранимую процедуру sp_trace_setevent можно выполнять только в остановленных существующих трассировках (параметр status равен 0). Будет возвращена ошибка, если эта хранимая процедура выполняется в несуществующей трассировке или параметр status которой не равен 0.

Значок ссылки на раздел Соглашения о синтаксическом обозначении в Transact-SQL

Синтаксис

sp_trace_setevent [ @traceid = ] trace_id 
          , [ @eventid = ] event_id
          , [ @columnid = ] column_id
          , [ @on = ] on

Аргументы

[ @traceid= ] trace_id
Идентификатор трассировки, подлежащей изменению. Аргумент trace_id имеет тип int без значения по умолчанию. Пользователь применяет это значение аргумента trace_id для идентификации, изменения и управления трассировкой.

[ @eventid= ] event_id
Идентификатор события, которое будет включено. Аргумент event_id имеет тип int и не имеет значения по умолчанию.

Эта таблица содержит список событий, которые можно добавить или удалить из трассировки.

Номер события	Имя события	Описание
0-9	Зарезервировано
10	RPC:Completed	Возникает при завершении удаленного вызова процедуры (RPC).
11	RPC:Starting	Возникает при запуске вызова удаленной процедуры RPC.
12	SQL:BatchCompleted	Возникает при завершении пакета языка Transact-SQL.
13	SQL:BatchStarting	Возникает при запуске пакета языка Transact-SQL.
14	Audit Login	Возникает, когда пользователь успешно входит в систему SQL Server.
15	Audit Logout	Возникает, когда пользователь выходит из системы SQL Server.
16	Attention	Возникает при событиях, требующих внимания, например запросах клиента на прерывание или разрыв соединения клиента.
17	ExistingConnection	Обнаруживает всю деятельность пользователей, соединенных с SQL Server до начала трассировки.
18	Audit Server Starts and Stops	Возникает при изменении состояния службы SQL Server.
19	DTCTransaction	Отслеживает согласованные транзакции координатора распределенных транзакций Майкрософт (MS DTC) между двумя или более базами данных.
20	Audit Login Failed	Показывает, что попытка входа клиента в систему SQL Server завершилась неудачно.
21	EventLog	Показывает, что события были записаны в журнал приложений Windows.
22	ErrorLog	Показывает, что связанные с ошибками события были записаны в журнал ошибок сервера SQL Server.
23	Lock:Released	Указывает, что была снята блокировка ресурса, например страницы.
24	Lock:Acquired	Указывает, что была установлена блокировка ресурса, например страницы данных.
25	Lock:Deadlock	Указывает, что две одновременно выполняемые транзакции взаимно блокируют друг друга, пытаясь установить несовместимые блокировки ресурсов, принадлежащих другой транзакции.
26	Lock:Cancel	Показывает, что запрос на блокировку ресурса был отменен (например, из-за взаимоблокировки).
27	Lock:Timeout	Показывает, что запрос на блокировку некоторого ресурса, например страницы, превысил время ожидания, поскольку данный ресурс был блокирован другой транзакцией. Время ожидания определяется функцией @@LOCK_TIMEOUT и может устанавливаться инструкцией SET LOCK_TIMEOUT.
28	Degree of Parallelism Event (используется с версии 7.0)	Возникает перед выполнением инструкций SELECT, INSERT и UPDATE.
29-31	Зарезервировано	Вместо него используется событие 28.
32	Зарезервировано
33	Exception	Указывает, что в сервере SQL Server произошло исключение.
34	SP:CacheMiss	Указывает, что хранимая процедура не найдена в процедурном кэше.
35	SP:CacheInsert	Указывает, что элемент вставлен в процедурный кэш.
36	SP:CacheRemove	Указывает, что элемент удален из процедурного кэша.
37	SP:Recompile	Указывает, что была выполнена повторная компиляция хранимой процедуры.
38	SP:CacheHit	Указывает, что хранимая процедура найдена в процедурном кэше.
39	Не используется
40	SQL:StmtStarting	Возникает при запуске инструкции Transact-SQL.
41	SQL:StmtCompleted	Возникает при завершении инструкции Transact-SQL.
42	SP:Starting	Указывает, что запущена хранимая процедура.
43	SP:Completed	Указывает, что выполнение хранимой процедуры завершено.
44	SP:StmtStarting	Указывает, что в хранимой процедуре начато выполнение инструкции Transact-SQL.
45	SP:StmtCompleted	Указывает, что выполнение инструкции Transact-SQL в хранимой процедуре завершено.
46	Object:Created	Указывает на создание объекта, например с помощью инструкций CREATE INDEX, CREATE TABLE или CREATE DATABASE.
47	Object:Deleted	Указывает на удаление объекта, например с помощью инструкций DROP INDEX или DROP TABLE.
48	Зарезервировано
49	Зарезервировано
50	SQL Transaction	Отслеживает инструкции языка Transact-SQL BEGIN, COMMIT, SAVE и ROLLBACK TRANSACTION.
51	Scan:Started	Указывает, что был начат просмотр таблицы или индекса.
52	Scan:Stopped	Указывает, что просмотр таблицы или индекса завершилось.
53	CursorOpen	Указывает, что в инструкции Transact-SQL с помощью API-функций ODBC, OLE DB или DB-Library был открыт курсор.
54	TransactionLog	Следит за записью транзакций в журнал транзакций.
55	Hash Warning	Указывает, что операция хэширования (например, Hash Join, Hash Aggregate, Hash Union и Hash Distinct), которая не выполняется в буферной секции, обратилась к альтернативному плану. Это может происходить из-за глубины рекурсии, неравномерного смещения данных, флагов трассировки или подсчета битов.
56-57	Зарезервировано
58	Auto Stats	Указывает, что произошло автоматическое обновление статистики индекса.
59	Lock:Deadlock Chain	Создается для каждого события, приводящего к взаимоблокировке.
60	Lock:Escalation	Указывает, что высокодетализированная блокировка была преобразована в менее детализированную (например, блокировка страницы была повышена или преобразована в блокировку таблицы).
61	OLE DB Errors	Показывает, что произошла ошибка OLE DB.
62-66	Зарезервировано
67	Execution Warnings	Показывает все предупреждения, которые были выданы за время выполнения инструкции или хранимой процедуры SQL Server.
68	Showplan Text (Unencoded)	Показывает дерево плана выполнения для текущей инструкции Transact-SQL.
69	Sort Warnings	Показывает операции сортировки, которые не помещаются в памяти. Сюда не входят операции сортировки, предполагающие создание индексов, а только операции сортировки в запросе (например, предложение ORDER BY инструкции SELECT).
70	CursorPrepare	Показывает, что курсор в инструкции Transact-SQL подготовлен для использования API-функциями ODBC, OLE DB или DB-Library.
71	Prepare SQL	API-функции ODBC, OLE DB или DB-Library подготовили одну или несколько инструкций Transact-SQL для использования.
72	Exec Prepared SQL	API-функции ODBC, OLE DB или DB-Library выполнили одну или несколько инструкций Transact-SQL.
73	Unprepare SQL	API-функции ODBC, OLE DB или DB-Library отменили готовность (удалили) одной или нескольких подготовленных инструкций Transact-SQL.
74	CursorExecute	Выполнен курсор, подготовленный в инструкции Transact-SQL с помощью API-функций ODBC, OLE DB или DB-Library.
75	CursorRecompile	Курсор, открытый в инструкции Transact-SQL с помощью API-функций ODBC или DB-Library, был повторно скомпилирован явным образом или вследствие изменения схемы. Срабатывает как для курсоров ANSI, так и для курсоров, не являющихся курсорами ANSI.
76	CursorImplicitConversion	Курсор в инструкции Transact-SQL преобразуется SQL Server из одного типа в другой. Срабатывает как для курсоров ANSI, так и для курсоров, не являющихся курсорами ANSI.
77	CursorUnprepare	API -функции ODBC, OLE DB или DB-Library отменяют готовность курсора (удаляют), подготовленного в инструкции Transact-SQL.
78	CursorClose	Закрыт курсор, предварительно открытый в инструкции Transact-SQL с помощью API-функций ODBC, OLE DB или DB-Library.
79	Missing Column Statistics	Недоступны статистические данные столбцов, которые были бы полезны оптимизатору.
80	Missing Join Predicate	Выполняется запрос, не имеющий предиката соединения. Это может привести к длительному выполнению запроса.
81	Server Memory Change	Объем памяти, используемый SQL Server, увеличился или уменьшился на 1 мегабайт (МБ) либо на 5% от максимального объема памяти, в зависимости от того, какая величина больше.
82-91	User Configurable (0-9)	Данные событий, определяемые пользователем.
92	Data File Auto Grow	Указывает, что сервер автоматически расширил файл данных.
93	Log File Auto Grow	Указывает, что сервер автоматически расширил файл журнала.
94	Data File Auto Shrink	Указывает, что сервер автоматически сжал файл данных.
95	Log File Auto Shrink	Указывает, что сервер автоматически сжал файл журнала.
96	Showplan Text	Показывает дерево плана запроса для инструкции SQL из оптимизатора запросов. Обратите внимание, что столбец TextData не содержит инструкцию Showplan для данного сообщения.
97	Showplan All	Выводит план запроса со всеми подробностями процесса компиляции для выполненной инструкции SQL. Обратите внимание, что столбец TextData не содержит инструкцию Showplan для данного сообщения.
98	Showplan Statistics Profile	Выводит план запроса со всеми подробностями времени выполнения для выполненной инструкции SQL. Обратите внимание, что столбец TextData не содержит инструкцию Showplan для данного сообщения.
99	Зарезервировано
100	RPC Output Parameter	Выводит выходные значения параметров для каждого вызова RPC.
101	Зарезервировано
102	Audit Statement GDR Event	Возникает каждый раз, когда пользователь SQL Server выдает разрешения GRANT, DENY, REVOKE на инструкции.
103	Audit Object GDR Event	Возникает каждый раз, когда пользователь SQL Server выдает разрешения GRANT, DENY, REVOKE на объект.
104	Audit AddLogin Event	Возникает, когда добавляется или удаляется имя входа SQL Server. Для хранимых процедур sp_addlogin и sp_droplogin.
105	Audit Login GDR Event	Происходит, когда добавляется или удаляется право входа в систему Windows. Для хранимых процедур sp_grantlogin, sp_revokelogin и sp_denylogin.
106	Audit Login Change Property Event	Возникает при изменении свойств имени входа, за исключением пароля. Для хранимых процедур sp_defaultdb и sp_defaultlanguage.
107	Audit Login Change Password Event	Возникает при изменении пароля имени входа SQL Server. Пароли не записываются.
108	Audit Add Login to Server Role Event	Возникает при изменении или удалении имени входа из фиксированной серверной роли. Для хранимых процедур sp_addsrvrolemember и sp_dropsrvrolemember.
109	Audit Add DB User Event	Возникает при добавлении или удалении из базы данных имени входа пользователя базы данных (Windows или SQL Server). Для хранимых процедур sp_grantdbaccess, sp_revokedbaccess, sp_adduser и sp_dropuser.
110	Audit Add Member to DB Role Event	Возникает при добавлении или удалении из базы данных имени входа пользователя базы данных (встроенного или пользовательского). Для хранимых процедур sp_addrolemember, sp_droprolemember и sp_changegroup.
111	Audit Add Role Event	Возникает при изменении или удалении из базы данных имени входа пользователя базы данных. Для хранимых процедур sp_addrole и sp_droprole.
112	Audit App Role Change Password Event	Возникает при изменении пароля роли приложения.
113	Audit Statement Permission Event	Возникает при использовании разрешения инструкции (например, CREATE TABLE).
114	Audit Schema Object Access Event	Возникает при использовании объектного разрешения (например, SELECT), как успешном, так и неуспешном.
115	Audit Backup/Restore Event	Возникает при выполнении команды BACKUP или RESTORE.
116	Audit DBCC Event	Возникает при выполнении консольной команды.
117	Audit Change Audit Event	Возникает при изменениях трассировки аудита.
118	Audit Object Derived Permission Event	Возникает при выполнении команд CREATE, ALTER и DROP в отношении объектов.
119	OLEDB Call Event	Возникает, когда поставщик OLE DB вызывает распределенные запросы и удаленные хранимые процедуры.
120	OLEDB QueryInterface Event	Возникает, когда интерфейс OLE DB QueryInterface вызывает распределенные запросы и удаленные хранимые процедуры.
121	OLEDB DataRead Event	Возникает при вызове запроса данных к поставщику OLE DB.
122	Showplan XML	Возникает при выполнении инструкции SQL. Включите это событие для идентификации операторов Showplan. Каждое событие хранится в правильно оформленном XML-документе. Обратите внимание, что столбец Binary для данного сообщения содержит закодированную инструкцию Showplan. Для просмотра инструкции Showplan откройте трассировку в приложении SQL Server Profiler.
123	SQL:FullTextQuery	Возникает при выполнении полнотекстового запроса.
124	Broker:Conversation	Сообщает о состоянии диалога компонента Service Broker.
125	Deprecation Announcement	Возникает при использовании возможности, которая будет удалена из будущей версии SQL Server.
126	Deprecation Final Support	Возникает при использовании возможности, которая будет удалена из следующего основного выпуска SQL Server.
127	Exchange Spill Event	Возникает, когда буферы связи в плане параллельного запроса были временно записаны в базу данных tempdb.
128	Audit Database Management Event	Возникает при создании, изменении и удалении базы данных.
129	Audit Database Object Management Event	Возникает при выполнении инструкций CREATE, ALTER или DROP в отношении таких объектов базы данных, как схема.
130	Audit Database Principal Management Event	Возникает при создании, изменении или удалении из базы данных таких участников, как пользователь.
131	Audit Schema Object Management Event	Возникает при создании, изменении и удалении серверных объектов.
132	Audit Server Principal Impersonation Event	Возникает при наличии в области действия сервера олицетворения, например EXECUTE AS LOGIN.
133	Audit Database Principal Impersonation Event	Возникает при наличии в области действия базы данных олицетворения, например EXECUTE AS USER или SETUSER.
134	Audit Server Object Take Ownership Event	Возникает при изменении владельца объектов в области действия сервера.
135	Audit Database Object Take Ownership Event	Возникает при изменении владельца объектов в области действия базы данных.
136	Broker:Conversation Group	Происходит, когда компонент Service Broker создает новую группу сообщений или удаляет существующую.
137	Blocked Process Report	Возникает, если процесс блокирован дольше, чем указанное время. Не включает системные процессы или процессы, ожидающие ресурсы, для которых невозможно определить состояние взаимоблокировки. Для настройки порога и частоты формирования отчетов используйте хранимую процедуру sp_configure.
138	Broker:Connection	Сообщает о состоянии транспортного соединения, управляемого компонентом Service Broker.
139	Broker:Forwarded Message Sent	Происходит, когда компонент Service Broker перенаправляет сообщение.
140	Broker:Forwarded Message Dropped	Происходит, когда компонент Service Broker удаляет сообщение, предназначенное для перенаправления.
141	Broker:Message Classify	Возникает при определении компонентом Service Broker маршрута сообщения.
142	Broker:Transmission	Показывает, что в транспортном уровне компонента Service Broker возникла ошибка. На источник ошибки указывает ее номер и значения состояния.
143	Broker:Queue Disabled	Указывает, что было обнаружено опасное сообщение, поскольку в очереди компонента Service Broker произошло пять последовательных откатов транзакций. Это событие содержит идентификаторы базы данных и очереди, в которой находится опасное сообщение.
144-145	Зарезервировано
146	Showplan XML Statistics Profile	Возникает при выполнении инструкции SQL. Идентифицирует операторы Showplan и выводит все данные процесса компиляции. Обратите внимание, что столбец Binary для данного сообщения содержит закодированную инструкцию Showplan. Для просмотра инструкции Showplan откройте трассировку в приложении SQL Server Profiler.
148	Deadlock Graph	Возникает в том случае, если попытка получить блокировку отменяется потому, что эта попытка была частью взаимоблокировки и была выбрана в качестве жертвы. Предоставляет описание взаимоблокировки в формате XML.
149	Broker:Remote Message Acknowledgement	Возникает при отправке или получении компонентом Service Broker подтверждения сообщения.
150	Trace File Close	Возникает при закрытии файла трассировки во время отката.
151	Зарезервировано
152	Audit Change Database Owner	Возникает при использовании инструкции ALTER AUTHORIZATION для изменения владельца базы данных и проверке разрешений на это действие.
153	Audit Schema Object Take Ownership Event	Возникает при использовании инструкции ALTER AUTHORIZATION для присвоения владельца объекту и проверке разрешений на это действие.
154	Зарезервировано
155	FT:Crawl Started	Возникает при запуске полнотекстового сканирования (заполнения). Используется для проверки, принят ли сканирующий запрос задачами-исполнителями.
156	FT:Crawl Stopped	Возникает при остановке полнотекстового сканирования (заполнения). Остановка происходит при успешном завершении сканирования или возникновении неустранимой ошибки.
157	FT:Crawl Aborted	Возникает при обнаружении исключения во время полнотекстового сканирования. Обычно приводит к остановке полнотекстового сканирования.
158	Audit Broker Conversation	Уведомляет о сообщениях аудита, связанных с безопасностью диалога компонента Service Broker.
159	Audit Broker Login	Уведомляет о сообщениях аудита, связанных с безопасностью транспорта компонента Service Broker.
160	Broker:Message Undeliverable	Возникает, если компоненту Service Broker не удается получить сообщение, которое должно быть доставлено службе.
161	Broker:Corrupted Message	Происходит, когда компонент Service Broker получает поврежденное сообщение.
162	User Error Message	Выводит сообщения об ошибках, которые пользователь видит в случае ошибки или исключения.
163	Broker:Activation	Возникает, если монитор очереди запускает хранимую процедуру активации, отправляет уведомление QUEUE_ACTIVATION или по завершению хранимой процедуры активации, запущенной монитором очереди.
164	Object:Altered	Возникает при изменении объекта базы данных.
165	Performance statistics	Возникает, если скомпилированный план запроса кэшируется впервые, повторно компилируется или удаляется из кэша плана.
166	SQL:StmtRecompile	Возникает при повторной компиляции на уровне инструкции.
167	Database Mirroring State Change	Возникает при изменении состояния зеркальной базы данных.
168	Showplan XML For Query Compile	Возникает при компиляции инструкции SQL. Выводит все данные процесса компиляции. Обратите внимание, что столбец Binary для данного сообщения содержит закодированную инструкцию Showplan. Для просмотра инструкции Showplan откройте трассировку в приложении SQL Server Profiler.
169	Showplan All For Query Compile	Возникает при компиляции инструкции SQL. Выводит все данные процесса компиляции. Используется для идентификации операторов Showplan.
170	Audit Server Scope GDR Event	Указывает, что возникло событие «предоставления», «запрещения» или «отмены» для разрешений в области действия сервера, например такое, как создание имени входа.
171	Audit Server Object GDR Event	Указывает, что возникло событие «предоставления», «запрещения» или «отмены» разрешения для объекта схемы, например для таблицы или функции.
172	Audit Database Object GDR Event	Указывает, что возникло событие «предоставления», «запрещения» или «отмены» разрешения для объектов базы данных, например для сборки или схемы.
173	Audit Server Operation Event	Возникает при использовании таких операций аудита безопасности, как изменение параметров, ресурсов, внешнего доступа или проверки подлинности.
175	Audit Server Alter Trace Event	Возникает при проверке инструкцией наличия разрешения ALTER TRACE.
176	Audit Server Object Management Event	Возникает при создании, изменении и удалении серверных объектов.
177	Audit Server Principal Management Event	Возникает при создании, изменении и удалении серверов-участников.
178	Audit Database Operation Event	Возникает при таких операциях базы данных, как уведомление запроса контрольной точки или подписки.
180	Audit Database Object Access Event	Возникает при доступе к таким объектам базы данных, как схема.
181	TM: Begin Tran starting	Возникает при запуске запроса BEGIN TRANSACTION.
182	TM: Begin Tran completed	Возникает при завершении запроса BEGIN TRANSACTION.
183	TM: Promote Tran starting	Возникает при запуске запроса PROMOTE TRANSACTION.
184	TM: Promote Tran completed	Возникает при завершении запроса PROMOTE TRANSACTION.
185	TM: Commit Tran starting	Возникает при запуске запроса COMMIT TRANSACTION.
186	TM: Commit Tran completed	Возникает при завершении запроса COMMIT TRANSACTION.
187	TM: Rollback Tran starting	Возникает при запуске запроса ROLLBACK TRANSACTION.
188	TM: Rollback Tran completed	Возникает при завершении запроса ROLLBACK TRANSACTION.
189	Lock:Timeout (timeout > 0)	Возникает при истечении времени ожидания запроса на блокировку ресурса, например страницы.
190	Progress Report: Online Index Operation	Сообщает о ходе выполнения операции оперативного построения индекса при работающем процессе построения.
191	TM: Save Tran starting	Возникает при запуске запроса SAVE TRANSACTION.
192	TM: Save Tran completed	Возникает при завершении запроса SAVE TRANSACTION.
193	Background Job Error	Возникает при аварийном завершении фонового задания.
194	OLEDB Provider Information	Возникает, если запускается распределенный запрос, который собирает сведения, относящиеся к соединению поставщика.
195	Mount Tape	Возникает при получении запроса на монтирование ленты.
196	Assembly Load	Возникает при запросе на загрузку сборки среды CLR.
197	Зарезервировано
198	XQuery Static Type	Возникает при выполнении выражения языка XQuery. Этот класс событий представляет статический тип выражения XQuery.
199	QN: subscription	Возникает, когда регистрация запроса не может быть подписана. Столбец TextData содержит сведения о событии.
200	QN: parameter table	Сведения об активных подписках хранятся во внутренней таблице параметров. Этот класс событий возникает, если создается или удаляется таблица параметров. Обычно такие таблицы создаются или удаляются при перезапуске базы данных. Столбец TextData содержит сведения о событии.
201	QN: template	Шаблон запроса представляет класс запросов на подписку. Как правило, запросы того же класса идентичны за исключением значений их параметров. Это событие возникает, если новый запрос на подписку принадлежит существующему классу (Match), новому классу (Create) или классу Drop, который указывает на очистку шаблонов классов запросов, не имеющих активных подписок. Столбец TextData содержит сведения о событии.
202	QN: dynamics	Отслеживает внутреннюю деятельность уведомлений запросов. Столбец TextData содержит сведения о событии.

[ @columnid= ] column_id
Идентификатор столбца, добавляемого к событию. Аргумент column_id имеет тип int и не имеет значения по умолчанию.

В следующей таблице приводится список столбцов, которые могут добавляться для события.

Номер столбца	Имя столбца	Описание
1	TextData	Текстовое значение, зависящее от класса событий, фиксируемых при трассировке.
2	BinaryData	Значение типа Binary, зависящее от класса событий, фиксируемых при трассировке.
3	DatabaseID	Идентификатор базы данных, указанный в инструкции USE database, или база данных по умолчанию, если для данного соединения инструкция USE database не выполнялась. Значение для базы данных можно определить с помощью функции DB_ID.
4	TransactionID	Назначенный системой идентификатор транзакции.
5	LineNumber	Содержит номер строки, в которой имеется ошибка. Для событий, в которых задействованы инструкции языка Transact-SQL, например SP:StmtStarting, столбец LineNumber содержит номер строки инструкции в хранимой процедуре или пакете.
6	NTUserName	Имя пользователя Microsoft Windows.
7	NTDomainName	Домен Windows, к которому принадлежит пользователь.
8	HostName	Имя клиентского компьютера, отправившего запрос.
9	ClientProcessID	Идентификатор, присвоенный клиентским компьютером процессу, в котором работает клиентское приложение.
10	ApplicationName	Имя клиентского приложения, установившего соединение с экземпляром SQL Server. Этот столбец заполняется значениями, передаваемыми приложением, а не отображаемым именем программы.
11	LoginName	Имя входа SQL Server для клиента.
12	SPID	Идентификатор процесса сервера, который SQL Server присвоил процессу, связанному с клиентом.
13	Длительность	Длительность события (в микросекундах). Этот столбец данных не заполняется событием Hash Warning.
14	StartTime	Время начала события, если оно доступно.
15	EndTime	Время окончания события. Этот столбец не заполняется для классов событий запуска, таких как SQL:BatchStarting или SP:Starting. Он также не заполняется событием Hash Warning.
16	Reads	Число логических чтений диска, выполненное сервером для данного события. Этот столбец не заполняется событием Lock:Released.
17	Writes	Число логических обращений к дискам на запись, выполненное сервером для данного события.
18	CPU	Объем времени ЦП (в миллисекундах), использованного событием.
19	Permissions	Представляет битовую карту разрешений. Используется событием Security Auditing.
20	Severity	Уровень серьезности исключения.
21	EventSubClass	Тип подкласса событий. Этот столбец данных не заполняется для всех классов событий.
22	ObjectID	Назначенный системой идентификатор объекта.
23	Success	Успех попытки использования разрешений. Применяется для аудита. 1 (успешное завершение) или 0 (неуспешное завершение)
24	IndexID	Идентификатор индекса объекта, связанного с событием. Чтобы определить идентификатор индекса для объекта, используйте столбец indid в системной таблице sysindexes.
25	IntegerData	Целочисленное значение, зависящее от класса событий, собираемых при трассировке.
26	ServerName	Имя экземпляра SQL Server (servername или servername\instancename), который отслеживается в настоящий момент.
27	EventClass	Тип класса событий, который записывается в настоящий момент.
28	ObjectType	Тип объекта, например: таблица, функция или хранимая процедура.
29	NestLevel	Уровень вложенности, на котором выполняется хранимая процедура. Дополнительные сведения см. в разделе @@NESTLEVEL (Transact-SQL).
30	Штат	Состояние сервера в случае ошибки.
31	ошибка;	Номер ошибки.
32	Mode	Режим полученной блокировки. Этот столбец не заполняется событием Lock:Released.
33	Handle	Дескриптор объекта, на который ссылается событие.
34	ObjectName	Имя объекта, к которому выполняется доступ.
35	DatabaseName	Имя базы данных, указанное в инструкции USE database.
36	FileName	Логическое имя изменяемого файла.
37	OwnerName	Имя владельца для объекта ссылки.
38	RoleName	Имя базы данных или серверной роли, к которым получает доступ инструкция.
39	TargetUserName	Пользовательское имя цели некоторой операции.
40	DBUserName	Имя пользовательской базы данных SQL Server для клиента.
41	LoginSid	Идентификатор безопасности (SID) вошедшего в систему пользователя.
42	TargetLoginName	Имя входа цели некоторой операции.
43	TargetLoginSid	Идентификатор безопасности имени входа, которое является целью некоторой операции.
44	ColumnPermissions	Состояние разрешений на уровне столбцов. Используется событием Security Auditing.
45	LinkedServerName	Имя связанного сервера.
46	ProviderName	Имя поставщика OLE DB.
47	MethodName	Имя метода OLE DB.
48	RowCounts	Количество строк в пакете.
49	RequestID	Идентификатор запроса, содержащего инструкцию.
50	XactSequence	Маркер для описания текущей транзакции.
51	EventSequence	Порядковый номер этого события.
52	BigintData1	Значение типа bigint, зависящее от класса событий, захваченного при трассировке.
53	BigintData2	Значение типа bigint, зависящее от класса событий, захваченного при трассировке.
54	GUID	Значение идентификатора GUID, зависящее от класса события, захваченного при трассировке.
55	IntegerData2	Целое число, значение которого зависит от класса событий, захваченного при трассировке.
56	ObjectID2	Идентификатор связанного объекта или сущности, если он доступен.
57	Type	Целое число, значение которого зависит от класса событий, захваченного при трассировке.
58	OwnerID	Тип объекта-владельца блокировки. Только для событий блокировки.
59	ParentName	Имя схемы, в которой находится объект.
60	IsSystem	Указывает, произошло ли событие в системном или в пользовательском процессе: 1 = системный процесс; 0 = пользовательский процесс.
61	Offset	Начальное смещение инструкции в пределах хранимой процедуры или пакета.
62	SourceDatabaseID	Идентификатор базы данных, в которой находится источник объекта.
63	SqlHandle	64-разрядный хэш, основанный на тексте нерегламентированного запроса или базы данных и идентификаторе объекта SQL. Это значение может быть передано в функцию sys.dm_exec_sql_text(), чтобы получить связанный SQL-текст.
64	SessionLoginName	Имя входа пользователя, который инициировал сеанс. Например, при подключении к SQL Server под именем Имя_входа1 и при выполнении инструкции под именем Имя_входа2 поле SessionLoginName будет содержать Имя_входа1, а поле LoginName — Имя_входа2. В данном столбце отображаются имена входа SQL Server и Windows.

**[ @on=\]**on
Указывает, включено ON (1) или выключено OFF (0) событие. Аргумент on имеет тип bit и не имеет значения по умолчанию.

Если аргумент on имеет значение 1, а аргумент column_id имеет значение NULL, то событие включается (ON), и все столбцы очищаются. Если аргумент column_id не имеет значение NULL, то столбец доступен (ON) для этого события.

Если аргумент on имеет значение 0, а аргумент column_id имеет значение NULL, то событие выключается (OFF), и все столбцы очищаются. Если аргумент column_id не имеет значения NULL, столбец выключается (OFF).

В следующей таблице показано взаимодействие между аргументами @on и @columnid.

@on	@columnid	Результат
ON (1)	NULL	Событие включено. Все столбцы очищены.
	NOT NULL	Столбец включен для указанного события.
OFF (0)	NULL	Событие выключено. Все столбцы очищены.
	NOT NULL	Столбец выключен для указанного события.

Значения кодов возврата

В следующей таблице описаны значения кодов, которые могут быть возвращены пользователю при завершении хранимой процедуры.

Код возврата	Описание
0	Нет ошибки.
1	Неизвестная ошибка.
2	Трассировка в данный момент выполняется. Изменение трассировки в это время приведет к ошибке.
3	Указанное событие недопустимо. Возможно, событие не существует или не соответствует ни одной хранимой процедуре.
4	Указан недопустимый столбец.
9	Указан недопустимый дескриптор трассировки.
11	Указанный столбец используется для внутренних целей и не может быть удален.
13	Недостаточно памяти. Возвращается, если для выполнения указанного действия недостаточно памяти.
16	Недопустимая функция для данной трассировки.

Замечания

Хранимая процедура sp_trace_setevent выполняет многие действия, которые в прежних версиях SQL Server выполняли расширенные хранимые процедуры. Процедура sp_trace_setevent используется вместо следующих процедур:

xp_trace_addnewqueue;
xp_trace_eventclassrequired;
xp_trace_seteventclassrequired.

Пользователи должны выполнить процедуру sp_trace_setevent для каждого столбца, который добавляется для всех событий. Во время выполнения, если аргумент @on имеет значение 1, то процедура sp_trace_setevent добавляет указанное значение к списку событий трассировки. Если аргумент @on имеет значение 0, то процедура sp_trace_setevent удаляет указанное событие из списка.

Аргументы всех хранимых процедур трассировки SQL (sp_trace_xx) строго типизированы. Если эти параметры не вызываются вместе с правильными типами данных входных параметров, как указано в описании аргумента, хранимая процедура возвращает ошибку.

Разрешения

Пользователь должен иметь разрешение ALTER TRACE.

См. также

Журнал изменений

Версия	Журнал
12 декабря 2006 г.	Изменения Исправлено описание события 168.

sp_trace_setevent (Transact-SQL)

Синтаксис

Аргументы

Значения кодов возврата

Замечания

Разрешения

См. также

Справочник

Другие ресурсы

Справка и поддержка

Журнал изменений

Дополнительные ресурсы