sp_syscollector_run_collection_set (Transact-SQL)

如果已启用收集器并将收集组配置为非缓存收集模式,则启动收集组。

备注

如果针对配置为缓存收集模式的收集组运行此过程,则会失败。

通过使用 sp_syscollector_run_collection_set,用户可以根据需要创建数据快照。

适用范围:SQL Server(SQL Server 2008 到当前版本)。

主题链接图标 Transact-SQL 语法约定

语法

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;

请参阅

参考

系统存储过程 (Transact-SQL)

概念

数据收集