NSEventBatchDetails (Transact-SQL)

Статья
12/15/2008

Возвращает подробные сведения о пакете событий в приложении Microsoft SQL Server Notification Services. Один результирующий набор содержит такие общие сведения о пакете событий, как имя поставщика событий и время сборки данного пакета. Второй результирующий набор отображает события, включенные в пакет.

Синтаксис

[ application_schema_name . ] NSEventBatchDetails 
    [ @EventClassName = ] 'event_class_name' ,
    [ @EventBatchId = ] event_batch_id

Аргументы

[ @EventClassName = ] 'event_class_name'
Имя класса событий. Аргумент event_class_name имеет тип nvarchar(255) и не имеет значения по умолчанию.

[ @EventBatchId = ] event_batch_id
Уникальный идентификатор пакета событий. Аргумент event_batch_id имеет тип bigint и не имеет значения по умолчанию.

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

Нет

Результирующие наборы

NSEventBatchDetails создает два результирующих набора. Первый результирующий набор содержит общие сведения о пакете событий.

Имя столбца	Тип данных	Описание
ProviderName	nvarchar(255)	Имя поставщика событий, отправившего пакет событий. Этот параметр имеет значение NULL, если события были непосредственно вставлены в представление <EventClassName>.
EventCount	bigint	Число событий в пакете.
StartCollectionTime	datetime	Дата и время начала сборки коллекции событий в формате UTC (универсальное синхронизированное время или среднее время по Гринвичу).
EndCollectionTime	datetime	Дата и время окончания сборки коллекции событий по Гринвичу (в формате UTC).
CollectionTimeInMS	int	Общее время сборки пакета событий (в мс).

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

Имя столбца	Тип данных	Описание
EventId	bigint	Номер идентификатора, определяющий соответствующее событие.
Event_class_field_name	определяемый приложением	Имя поля класса событий, определенное в файле определения приложения (ADF). Каждый столбец результирующего набора соответствует полю класса событий.

Замечания

При создании экземпляра службы Notification Services создают в базе данных приложения хранимую процедуру NSEventBatchDetails. При обновлении приложения службы Notification Services перекомпилируют хранимую процедуру.

Эта хранимая процедура находится в схеме приложения, которая указывается элементом SchemaName файла определения приложения (ADF). Если имя схемы не указано, по умолчанию используется схема dbo.

Разрешения

По умолчанию разрешения на выполнение предоставляются членам роли базы данных NSAnalysis, фиксированной роли базы данных db_owner и фиксированной серверной роли sysadmin.

Примеры

А. Использование схемы приложения по умолчанию

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

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

EXEC dbo.NSEventBatchDetails 
    @EventClassName = N'StockEvents',
    @EventBatchId = 1;

Б. Использование именованной схемы приложения

В следующем примере показано, как создать отчет о пакете событий, если хранимая процедура (как и все остальные объекты) расположена в схеме Stock, указанной элементом SchemaName файла ADF.

EXEC Stock.NSEventBatchDetails 
    @EventClassName = N'StockEvents',
    @EventBatchId = 1;

См. также

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