sp_syscollector_run_collection_set (Transact-SQL)
适用范围:SQL Server
如果收集器已启用,并且为非缓存的收集模式配置了收集集,则启动收集集。
注意
如果针对为缓存的收集模式配置的收集集运行此过程,此过程将失败。
sp_syscollector_run_collection_set
使用户能够拍摄按需数据快照。
语法
sp_syscollector_run_collection_set
[ [ @collection_set_id = ] collection_set_id ]
[ , [ @name = ] N'name' ]
[ ; ]
参数
[ @collection_set_id = ] collection_set_id
集合集的唯一本地标识符。 @collection_set_id为 int,默认值NULL
为 int,如果@name,NULL
则必须具有值。
[ @name = ] N'name'
收集组的名称。 @name是 sysname,默认值NULL
为 ,并且如果@collection_set_id为NULL
值,则必须具有值。
返回代码值
0
(成功)或 1
(失败)。
注解
@collection_set_id或@name必须有一个值,两者都NULL
不能。
此过程启动指定集合集的集合并上传作业,如果集合集的 @collection_mode 设置为非缓存(1
),则立即启动收集代理作业。 有关详细信息,请参阅 sp_syscollector_create_collection_set。
sp_sycollector_run_collection_set
还可用于运行没有计划的收集集。
权限
要求dc_operator(具有 EXECUTE 权限)固定数据库角色的成员身份才能执行此过程。
示例
使用收集组的标识符启动收集组。
USE msdb;
GO
EXEC sp_syscollector_run_collection_set
@collection_set_id = 1;