sp_syscollector_run_collection_set (Transact-SQL)

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

注意注意

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

利用 sp_syscollector_run_collection_set,用户能够根据需要创建数据快照。

主题链接图标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

请参阅

参考

其他资源