Поделиться через


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

Добавляет к трассировке или удаляет из нее событие либо столбец событий. Хранимую процедуру 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

Указывает, что блокировка более мелких фрагментов данных была преобразована в блокировку более крупных фрагментов данных (например, блокировка страницы была укрупнена или преобразована в блокировку таблицы или блокировку HoBT).

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

Возникает при использовании инструкции 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: подписка

Возникает, когда регистрация запроса не может быть подписана. Столбец 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

Указывает, что в SQL Server успешно создан план выполнения для запроса или пакета, в котором содержится структура плана.

218

Plan Guide Unsuccessful

Указывает, что в SQL Server не удалось создать план выполнения для запроса или пакета, в котором содержится структура плана. SQL Server пытался создать план выполнения запроса или пакета без использования структуры плана. Причиной возникновения этой проблемы может быть недопустимая структура плана. С помощью системной функции sys.fn_validate_plan_guide можно проверить допустимость структуры плана.

235

Audit Fulltext

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

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

Номер столбца

Имя столбца

Описание

1

TextData

Текстовое значение, зависящее от класса событий, фиксируемых при трассировке.

2

BinaryData

Значение двоичного типа, зависящее от класса событий, фиксируемых при трассировке.

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

Duration

Длительность события (в микросекундах). Этот столбец данных не заполняется событием Hash Warning.

14

StartTime

Время начала события, если оно доступно.

15

EndTime

Время окончания события. Этот столбец не заполняется для классов событий запуска, таких как SQL:BatchStarting или SP:Starting. Он также не заполняется событием Hash Warning.

16

Reads

Число логических чтений диска, выполненное сервером для данного события. Этот столбец не заполняется событием Lock:Released.

17

Writes

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

18

CPU

Объем времени ЦП (в миллисекундах), использованного событием.

19

Разрешения

Представляет битовую карту разрешений. Используется событием 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

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

Идентификатор защиты (SID) вошедшего в систему пользователя.

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

Тип

Целое число, значение которого зависит от класса событий, захваченного при трассировке.

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 Trace (sp_trace_xx) строго типизированы. Если эти параметры не вызываются вместе с правильными типами данных входных параметров, как указано в описании аргумента, хранимая процедура возвращает ошибку.

Пример использования хранимых процедур трассировки см. в разделе Как создать трассировку (Transact-SQL).

Разрешения

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