NSQuantumList (Transact-SQL)
为 Microsoft SQL Server Notification Services 应用程序生成量程列表报表。该报表包含指定时间段内处理的量程的信息,其中量程均按执行顺序显示。
语法
[ schema_name . ] NSQuantumList
[ @StartTime = ] 'start_time',
[ @EndTime = ] 'end_time'
参数
[ @StartTime = ] 'start_time'
要包含在结果集中的一个时间段的开始日期和时间,以 UTC(通用协调时间)表示。量程表示时间段,但不必在该时间执行。
start_time 的数据类型为 datetime,无默认值。
[ @EndTime = ] 'end_time'
要包含在结果集中的一个时间段的结束日期和时间,以 UTC(通用协调时间)表示。量程表示时间段,但不必在该时间执行。
end_time 的数据类型为 datetime,无默认值。
返回代码值
无
结果集
NSQuantumList 结果集按 QuantumId 排序。
列名 | 数据类型 | 说明 |
---|---|---|
QuantumId |
int |
量程的唯一 ID。可以将此 ID 提供给 NSQuantumDetails 存储过程以获取有关量程的其他信息。 |
StartTime |
datetime |
量程所代表时间段的开始时间,以 UTC 表示。 |
EndTime |
datetime |
量程表示的时间段的结束时间,以 UTC 表示。结束时间是开始时间加上量程持续时间。 |
SkippedCount |
int |
在此量程之前跳过的量程期的数量。 |
QuantumStatusDescription |
nvarchar(255) |
说明量程当前状态的文本。 |
ExecutionTimeInMS |
int |
生成器开始处理量程的实际日期和时间,以 UTC 表示。 |
ExecutionStartTime |
datetime |
生成器完成处理量程的实际日期和时间,以 UTC 表示。 |
ExecutionEndTime |
datetime |
量程停止处理通知的日期和时间,以 UTC 表示。 |
EventNotificationsGenerated |
int |
在量程持续期间,由事件触发规则生成的通知数。 |
ScheduledNotificationsGenerated |
int |
在量程持续期间,由预定的订阅规则生成的通知数。 |
EventChronicleRuleFiringsSkipped |
nvarchar(255) |
指示是否由于应用程序的历史记录量程限制而跳过了事件历史记录规则触发。可能的值为 Yes 和 No。 |
SubscriptionRuleFiringsSkipped |
nvarchar(255) |
表示是否由于应用程序的订阅量程限制而跳过订阅规则触发。可能的值为 Yes 和 No。 |
备注
当创建实例时,Notification Services 会在应用程序数据库中创建 NSQuantumList 存储过程。在更新应用程序时,Notification Services 会重新编译此存储过程。
此存储过程位于应用程序的架构中,该架构由应用程序定义文件 (ADF) 的 SchemaName 元素指定。如果没有提供架构名称,默认架构为 dbo。
@StartTime 和 @EndTime 值根据量程的 StartTime 和 EndTime 值(而非 ExecutionStartTime 和 ExecutionEndTime 值)来筛选结果。您可以通过运行 NSQuantumDetails 存储过程来查看量程的这些值。
若要确定当前 UTC 日期和时间,请在 SQL Server Management Studio 中运行 SELECT GETUTCDATE()。当前的 UTC 时间源自运行 SQL Server 的计算机操作系统中的当前本地时间和时区设置。
权限
执行权限默认授予 NSAnalysis 数据库角色、db_owner 固定数据库角色和 sysadmin 固定服务器角色的成员。
示例
以下示例显示在 2004 年 5 月 22 日凌晨 2:30 开始至凌晨 3:30 (UTC) 之间开始执行和结束执行的所有量程。
应用程序使用默认的 SchemaName 设置,该设置将所有应用程序对象置于 dbo 架构中。
EXEC dbo.NSQuantumList
@StartTime = '2004-05-22 02:30:00',
@EndTime = '2004-05-22 03:30:00'
请参阅
参考
Notification Services 存储过程 (Transact-SQL)
NSQuantumDetails (Transact-SQL)
其他资源
Notification Services 性能报告
SchemaName Element (ADF)