Хранимая процедура sp_trace_setevent (Transact-SQL)

  • Статья

Область применения: SQL Server

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

Внимание

Эта функция будет удалена в будущей версии SQL Server. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется. Вместо этого используйте расширенные события.

Соглашения о синтаксисе Transact-SQL

Синтаксис

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

Аргументы

[ @traceid = ] traceid

Идентификатор измененной трассировки. @traceid не используется без значения по умолчанию. Пользователь использует это значение @traceid для идентификации, изменения и управления трассировки.

[ @eventid = ] eventid

Идентификатор события для включения. @eventid не используется без значения по умолчанию.

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

Номер события Имя события Description
0...9 Reserved Зарезервировано
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 Возникает перед выполнением инструкций SELECT, INSERT и UPDATE.
29...31 Reserved Вместо него используется событие 28.
32 Reserved Зарезервировано
33 Exception Указывает, что в SQL Server произошло исключение.
34 SP:CacheMiss Указывает, когда хранимая процедура не найдена в кэше процедур.
35 SP:CacheInsert Указывает, что элемент вставлен в процедурный кэш.
36 SP:CacheRemove Указывает, что элемент удален из процедурного кэша.
37 SP:Recompile Указывает, что была выполнена повторная компиляция хранимой процедуры.
38 SP:CacheHit Указывает, что хранимая процедура найдена в процедурном кэше.
39 Deprecated Устарело
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 Reserved
49 Reserved
50 SQL Transaction Отслеживает инструкции Transact-SQL BEGIN, COMMIT, SAVE и ROLLBACK TRANSACTION.
51 Scan:Started Указывает, что был начат просмотр таблицы или индекса.
52 Scan:Stopped Указывает, что просмотр таблицы или индекса завершилось.
53 CursorOpen Указывает, когда курсор открыт в инструкции Transact-SQL ODBC, OLE DB или DB-Library.
54 TransactionLog Следит за записью транзакций в журнал транзакций.
55 Hash Warning Указывает, что операция хэширования (например, хэш-соединение, хэш-агрегат, хэш-объединение и хэш-различающееся) не обрабатывается в буферном разделе, вернулась к альтернативному плану. Это может происходить из-за глубины рекурсии, неравномерного смещения данных, флагов трассировки или подсчета битов.
56...57 Reserved
58 Auto Stats Указывает, что произошло автоматическое обновление статистики индекса.
59 Lock:Deadlock Chain Создается для каждого события, приводящего к взаимоблокировке.
60 Lock:Escalation Указывает, что блокировка более мелких фрагментов данных была преобразована в блокировку более крупных фрагментов данных (например, блокировка страницы была укрупнена или преобразована в блокировку таблицы или блокировку HoBT).
61 OLE DB Errors Показывает, что произошла ошибка OLE DB.
62...66 Reserved
67 Execution Warnings Указывает все предупреждения, которые произошли во время выполнения инструкции SQL Server или хранимой процедуры.
68 Showplan Text (Unencoded) Отображает дерево плана выполняемой инструкции Transact-SQL.
69 Sort Warnings Указывает операции сортировки, которые не помещаются в память. Не включает операции сортировки, связанные с созданием индексов; только операции сортировки в запросе (например, предложение ORDER BY, используемое в инструкции SELECT).
70 CursorPrepare Указывает, когда курсор в инструкции Transact-SQL подготовлен для использования ODBC, OLE DB или DB-Library.
71 Prepare SQL ODBC, OLE DB или DB-Library подготовили инструкцию или инструкции Transact-SQL для использования.
72 Exec Prepared SQL ODBC, OLE DB или БИБЛИОТЕКА DB выполнили подготовленную инструкцию Или инструкции Transact-SQL.
73 Unprepare SQL ODBC, OLE DB или DB-Library не подготовлены (удалены) подготовленные инструкции или инструкции Transact-SQL.
74 CursorExecute Выполняется курсор, подготовленный ранее в инструкции Transact-SQL ODBC, OLE DB или DB-Library.
75 CursorRecompile Курсор, открытый в инструкции Transact-SQL ODBC или DB-Library, был перекомпилирован либо напрямую, либо из-за изменения схемы.

Срабатывает как для курсоров ANSI, так и для курсоров, не являющихся курсорами ANSI.
76 CursorImplicitConversion Курсор инструкции Transact-SQL преобразуется SQL Server из одного типа в другой.

Срабатывает как для курсоров ANSI, так и для курсоров, не являющихся курсорами ANSI.
77 CursorUnprepare Подготовленный курсор инструкции Transact-SQL не подготовлен (удален) ODBC, OLE DB или DB-Library.
78 CursorClose Курсор, ранее открытый в инструкции Transact-SQL, 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 Reserved
100 RPC Output Parameter Выводит выходные значения параметров для каждого вызова RPC.
101 Reserved
102 Audit Database Scope GDR Происходит каждый раз, когда разрешение GRANT, DENY для инструкции выдано любым пользователем в SQL Server для действий только для базы данных, таких как предоставление разрешений на базу данных.
103 Audit Object GDR Event Происходит каждый раз, когда разрешение GRANT, DENY, REVOKE для разрешения объекта выдано любым пользователем в SQL Server.
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_addusersp_revokedbaccessи 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 Происходит при удалении сообщения, которое должно быть переадресовано.
141 Broker:Message Classify Происходит, когда Service Broker определяет маршрутизацию сообщения.
142 Broker:Transmission Указывает, что ошибки произошли на уровне транспорта Service Broker. На источник ошибки указывает ее номер и значения состояния.
143 Broker:Queue Disabled Указывает, что обнаружено сообщение об ошибке, так как в очереди Service Broker было обнаружено пять последовательных откатов транзакций. Это событие содержит идентификаторы базы данных и очереди, в которой находится опасное сообщение.
144...145 Reserved
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 Reserved
152 Audit Change Database Owner Возникает при использовании инструкции ALTER AUTHORIZATION для изменения владельца базы данных и проверке разрешений на это действие.
153 Audit Schema Object Take Ownership Event Возникает при использовании инструкции ALTER AUTHORIZATION для присвоения владельца объекту и проверке разрешений на это действие.
154 Reserved
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 Reserved
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 содержит сведения о событии.
212 Bitmap Warning Указывает, что в запросе отключена фильтрация по битовым картам.
213 Database Suspect Data Page Указывает, когда страница добавляется в таблицу suspect_pages msdb.
214 CPU threshold exceeded Указывает, когда регулятор ресурсов обнаруживает, что запрос превысил пороговое значение ЦП (REQUEST_MAX_CPU_TIME_SEC).
215 PreConnect:Starting Указывает на запуск триггера LOGON или функции-классификатора регулятора ресурсов.
216 PreConnect:Completed Указывает на завершение работы триггера LOGON или функции-классификатора регулятора ресурсов.
217 Plan Guide Successful Указывает, что ядро СУБД успешно создал план выполнения для запроса или пакета, содержащего руководство по плану.
218 Plan Guide Unsuccessful Указывает, что ядро СУБД не удалось создать план выполнения для запроса или пакета, содержащего руководство по плану. Ядро СУБД попытались создать план выполнения для этого запроса или пакета без применения руководства по плану. Недопустимое руководство по плану может быть причиной этой проблемы. Руководство по плану можно проверить с помощью системной sys.fn_validate_plan_guide функции.
235 Audit Fulltext

[ @columnid = ] columnid

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

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

Номер столбца Имя столбца Description
1 TextData Текстовое значение, зависящее от класса событий, фиксируемых при трассировке.
2 BinaryData Значение типа Binary, зависящее от класса событий, фиксируемых при трассировке.
3 DatabaseID Идентификатор базы данных, указанной инструкцией USE database, или базы данных по умолчанию, если инструкция USE database не выдана для данного подключения.

Значение для базы данных можно определить с помощью функции DB_ID.
4 TransactionID Назначенный системой идентификатор транзакции.
5 LineNumber Содержит номер строки, в которой имеется ошибка. Для событий, включающих инструкции Transact-SQL, например SP:StmtStarting, LineNumber содержит номер строки инструкции в хранимой процедуре или пакете.
6 NTUserName Имя пользователя Windows.
7 NTDomainName Домен Windows, к которому принадлежит пользователь.
8 HostName Имя клиентского компьютера, отправившего запрос.
9 ClientProcessID Идентификатор, присвоенный клиентским компьютером процессу, в котором работает клиентское приложение.
10 ApplicationName Имя клиентского приложения, создавшего подключение к экземпляру SQL Server. Этот столбец заполняется значениями, передаваемыми приложением, а не отображаемым именем программы.
11 LoginName Имя входа SQL Server клиента.
12 SPID Идентификатор процесса сервера, назначенный SQL Server процессу, связанному с клиентом.
13 Duration Длительность события (в микросекундах). Этот столбец данных не заполняется событием 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, имя сервера или имя_сервера\имя_экземпляра, отслеживаемое.
27 EventClass Тип класса событий, который записывается в настоящий момент.
28 ObjectType Тип объекта, например: таблица, функция или хранимая процедура.
29 NestLevel Уровень вложенности, на котором выполняется хранимая процедура. См . @@NESTLEVEL.
30 State Состояние сервера в случае ошибки.
31 Error Номер ошибки.
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 Идентификатор безопасности вошедшего в систему пользователя.
42 TargetLoginName Имя входа цели некоторой операции.
43 TargetLoginSid Идентификатор SID имени входа, которое является целью некоторой операции.
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 с помощью Login1 и выполняете инструкцию как Login2, SessionLoginName отображается Login1, пока LoginName отображается Login2. В этом столбце данных отображаются имена входа SQL Server и Windows.

[ @on = ] в

Указывает, включает ли событие (1) или отключает (0). @on бит, без значения по умолчанию.

Если для @on задано 1значение , и @columnid NULLесть, то событие устанавливается и ON все столбцы очищаются. Если @columnid не имеет значения NULL, столбец имеет значение ON для этого события.

Если для @on задано 0значение , и @columnid есть NULL, событие повернуто OFF и все столбцы очищаются. Если @columnid не имеет значения NULL, столбец отключен.

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

@on @columnid Результат
ON (1) NULL Событие включено.

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

Все столбцы очищены.
NOT NULL Столбец отключен для указанного события.

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

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

Код возврата Description
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 для каждого столбца, добавленного для каждого события. При каждом выполнении, если задано 1значение @on, sp_trace_setevent добавляет указанное событие в список событий трассировки. Если задано 0значение @on, sp_trace_setevent удаляет указанное событие из списка.

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

Пример использования хранимых процедур трассировки см. в разделе "Создание трассировки".

Разрешения

Требуется разрешение ALTER TRACE.

Связанный контент