NSEventBatchDetails (Transact-SQL)
返回有关 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) |
提交此事件批次提供程序的名称。如果直接将事件插入 <EventClassName> 视图中,则该值为 NULL。 |
EventCount |
bigint |
事件批次中的事件数。 |
StartCollectionTime |
datetime |
开始收集事件批次的日期和时间,采用 UTC(通用协调时间)格式或格林尼治标准时间格式。 |
EndCollectionTime |
datetime |
结束收集事件批次的日期和时间,采用 UTC 格式。 |
CollectionTimeInMS |
int |
收集此事件批次的总时间(毫秒)。 |
第二个结果集中包含有关事件批次中提交的事件的详细信息,按 EventId 列排序。
列名 | 数据类型 | 说明 |
---|---|---|
EventId |
bigint |
用于标识事件的 ID 号。 |
Event_class_field_name |
由应用程序定义 |
事件类字段的名称,在应用程序定义文件 (ADF) 中定义。事件类中的每个字段由结果集中的一列来表示。 |
备注
当创建实例时,Notification Services 会在应用程序数据库中创建 NSEventBatchDetails 存储过程。在更新应用程序时,Notification Services 会重新编译此存储过程。
此存储过程位于应用程序的架构中,该架构由应用程序定义文件 (ADF) 的 SchemaName 元素指定。如果没有提供架构名称,默认架构为 dbo。
权限
执行权限默认授予 NSAnalysis 数据库角色、db_owner 固定数据库角色和 sysadmin 固定服务器角色的成员。
示例
使用默认的应用程序架构
以下示例显示如何生成事件批次详细信息报表。应用程序使用默认的 SchemaName 设置,该设置将所有应用程序对象置于 dbo 架构中。
该报表包含两个结果集。第一个结果集显示事件批次的事件提供程序和事件收集信息,第二个结果集显示事件批次中提交的事件。
EXEC dbo.NSEventBatchDetails
@EventClassName = N'StockEvents',
@EventBatchId = 1;
B. 使用命名的应用程序架构
以下示例显示如何在存储过程(如同其他所有应用程序对象)使用 Stock 架构(在 ADF 的 SchemaName 元素中指定)时生成事件批次报表。
EXEC Stock.NSEventBatchDetails
@EventClassName = N'StockEvents',
@EventBatchId = 1;
请参阅
参考
Notification Services 存储过程 (Transact-SQL)
其他资源
Notification Services 性能报告
SchemaName Element (ADF)