Класс событий CursorOpen

Класс событий CursorOpen описывает события открытия курсора, которые происходят в курсорах API-интерфейса. События открытия курсора происходят, когда Компонент SQL Server Database Engine определяет инструкцию SQL, которая должна быть связана с курсором или параметрами курсора, и заполняет курсор.

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

Столбцы данных класса событий CursorOpen

Имя столбца данных

Тип данных

Описание

Идентификатор столбца

Фильтруемый

ApplicationName

nvarchar

Имя клиентского приложения, установившего соединение с экземпляром SQL Server. Этот столбец заполняется значениями, передаваемыми приложением, а не отображаемым именем программы.

10

Да

ClientProcessID

int

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

9

Да

DatabaseID

int

Идентификатор базы данных, указанной в инструкции USE database, или базы данных по умолчанию, если для данного экземпляра инструкция USE databaseне выполнялась. Приложение SQL Server Profiler отображает имя базы данных, если столбец данных ServerName захвачен при трассировке и сервер доступен. Определите значение для базы данных, используя функцию DB_ID.

3

Да

DatabaseName

nvarchar

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

35

Да

EventClass

int

Тип регистрируемого события = 53.

27

Нет

EventSequence

int

Порядок класса событий CursorOpen в пакете.

51

Нет

GroupID

int

Идентификатор группы рабочей нагрузки, в которой запускается событие трассировки SQL.

66

Да

Handle

int

Целочисленное значение, используемое функциями ODBC, OLE DB или DB-Library для координации работы с сервером.

33

Да

HostName

nvarchar

Имя компьютера, на котором выполняется клиентская программа. Этот столбец данных заполняется, если клиент предоставляет имя узла. Чтобы определить имя узла, используйте функцию HOST_NAME.

8

Да

IntegerData

int

Тип курсора. Значения:

1 = набор ключей

2 = динамический

4 = Однонаправленный

8 = Статический

16 = Опережающий

25

Да

IsSystem

int

Указывает, произошло событие в системном или в пользовательском процессе. 1 = системный, 0 = пользовательский.

60

Да

LoginName

nvarchar

Имя входа пользователя (либо защищенное имя входа SQL Server, либо учетные данные входа Microsoft Windows в формате «ДОМЕН\имя_пользователя»).

11

Да

LoginSid

image

Идентификатор безопасности вошедшего в систему пользователя. Эти сведения можно найти в представлении каталога sys.server_principals. Значение идентификатора безопасности уникально для каждого имени входа на сервере.

41

Да

NTDomainName

nvarchar

Домен Windows, к которому принадлежит пользователь.

7

Да

NTUserName

nvarchar

Имя пользователя Windows.

6

Да

RequestID

int

Идентификатор запроса, открывший курсор.

49

Да

ServerName

nvarchar

Имя экземпляра SQL Server, для которого выполняется трассировка.

26

Нет

SessionLoginName

nvarchar

Имя входа пользователя, создавшего сеанс. Например, при подключении к SQL Server по имени Имя_входа1 и при выполнении инструкции под именем Имя_входа2 SessionLoginName содержит значение «Имя_входа1», а LoginName содержит значение «Имя_входа2». В этом столбце отображаются как имена входа SQL Server, так и имена входа Windows.

64

Да

SPID

int

Идентификатор сеанса, в котором произошло событие.

12

Да

StartTime

datetime

Время начала события, если оно известно.

14

Да

TransactionID

bigint

Назначенный системой идентификатор транзакции.

4

Да

XactSequence

bigint

Токен, описывающий текущую транзакцию.

50

Да

См. также

Справочник

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

Основные понятия

Расширенные события

Курсоры