sp_syscollector_run_collection_set (Transact-SQL)
如果已启用收集器并将收集组配置为非缓存收集模式,则启动收集组。
备注
如果针对配置为缓存收集模式的收集组运行此过程,则会失败。
通过使用 sp_syscollector_run_collection_set,用户可以根据需要创建数据快照。
适用范围:SQL Server(SQL Server 2008 到当前版本)。 |
语法
sp_syscollector_run_collection_set [[ @collection_set_id = ] collection_set_id ]
, [[ @name = ] 'name' ]
参数
[ @collection_set_id = ] collection_set_id
收集组的唯一本地标识符。 collection_set_id 的数据类型为 int,且在 name 为 NULL 时必须具有值。[ @name = ] 'name'
收集组的名称。 name 的数据类型为 sysname,且在 collection_set_id 为 NULL 时必须具有值。
返回代码值
0(成功)或 1(失败)
注释
collection_set_id 或 name 必须具有值,不能两者均为 NULL。
此过程将为指定的收集组启动收集和上载作业;如果收集组的 @collection_mode 设置为非缓存 (1),则会立即启动收集代理作业。 有关详细信息,请参阅 sp_syscollector_create_collection_set (Transact-SQL)。
sp_sycollector_run_collection_set 还可以用于运行没有计划的收集组。
权限
需要具有 dc_operator(拥有 EXECUTE 权限)固定数据库角色的成员身份才能执行此过程。
示例
使用收集组的标识符启动收集组。
USE msdb;
GO
EXEC sp_syscollector_run_collection_set @collection_set_id = 1;