项目
04/01/2012

sp_syscollector_update_collection_set (Transact-SQL)

用于修改用户定义的收集组的属性或重命名用户定义的收集组。

语法

sp_syscollector_update_collection_set 
    [ [ @collection_set_id = ] collection_set_id ]
        , [ [ @name = ] 'name' ]
        , [ [ @new_name = ] 'new_name' ]
        , [ [ @target = ] 'target' ]
        , [ [ @collection_mode = ] collection_mode ]
        , [ [ @days_until_expiration = ] days_until_expiration ]
        , [ [ @proxy_id = ] proxy_id ]
        , [ [ @proxy_name = ] 'proxy_name' ]
        ,[ [ @schedule_uid = ] 'schedule_uid' ]
        ,[ [ @schedule_name = ] 'schedule_uid' ]
        , [ [ @logging_level = ] logging_level ]
        , [ [ @description = ] 'description' ]

参数

[ @collection_set_id = ] collection_set_id
是收集组的唯一本地标识符。collection_set_id 的数据类型为 int，且在 name 为 NULL 时必须具有值。
[ @name = ] 'name'
是收集组的名称。name 的数据类型为 sysname，且在 collection_set_id 为 NULL 时必须具有值。
[ @new_name = ] 'new_name'
是收集组的新名称。new_name 的数据类型为 sysname，并且如果使用该参数，则不能为空字符串。new_name 必须唯一。有关当前收集组名称的列表，请查询 syscollector_collection_sets 系统视图。
[ @target = ] 'target'
保留供将来使用。
[ @collection_mode = ] collection_mode
是要使用的数据收集的类型。collection_mode 的数据类型为 smallint，并且可具有下列值之一：

0 - 缓存模式。数据收集和上载分别位于各自的计划中。为连续收集指定缓存模式。

1 - 非缓存模式。数据的收集和上载位于同一个计划中。为临时收集或快照收集指定非缓存模式。

如果从非缓存模式更改为缓存模式 (0)，则还必须指定 schedule_uid 或 schedule_name。
[ @days_until_expiration= ] days_until_expiration
表示收集的数据保存在管理数据仓库中的天数。days_until_expiration 的数据类型为 smallint。days_until_expiration 必须为 0 或正整数。
[ @proxy_id = ] proxy_id
SQL Server 代理的代理帐户的唯一标识符。proxy_id 的数据类型为 int。
[ @proxy_name = ] 'proxy_name'
代理的名称。proxy_name 的数据类型为 sysname，并且可为 Null。
[ @schedule_uid = ] 'schedule_uid'
是指向计划的 GUID。schedule_uid 的数据类型为 uniqueidentifier。

若要获取 schedule_uid，请查询 sysschedules 系统表。

如果将 collection_mode 设置为 0，则必须指定 schedule_uid 或 schedule_name。如果将 collection_mode 设置为 1，则忽略 schedule_uid 或 schedule_name（如果指定）。
[ @schedule_name = ] 'schedule_name'
计划的名称。schedule_name 的数据类型为 sysname，并且可以为 Null。如果指定了此参数，则 schedule_uid 必须为 NULL。若要获取 schedule_name，请查询 sysschedules 系统表。
[ @logging_level = ] logging_level
表示日志记录级别。logging_level 的数据类型为 smallint，可以是以下值之一：

0 - 记录执行信息和跟踪以下内容的 SSIS 事件：
- 启动/停止收集组
- 启动/停止包
- 错误信息
1 - 级别 0 日志记录和：
- 执行统计信息
- 连续运行收集的进度
- 来自 SSIS 的警告事件
2 - 级别 1 日志记录和来自 SSIS 的详细事件信息。

logging_level 的默认值为 1。
[ @description = ] 'description'
收集组的说明。description 的数据类型为 nvarchar(4000)。

返回代码值

0（成功）或 1（失败）

注释

sp_syscollector_update_collection_set 必须在 msdb 系统数据库的上下文中运行。

collection_set_id 或 name 必须具有值，不能两者均为 NULL。若要获取这些值，请查询 syscollector_collection_sets 系统视图。

如果收集组正在运行，您只能更新 schedule_uid 和 description。若要停止收集组，请使用 sp_syscollector_stop_collection_set。

权限

要求具有 dc_admin 或 dc_operator（拥有 EXECUTE 权限）固定数据库角色的成员身份才能执行此过程。尽管 dc_operator 可以运行此存储过程，但是此角色的成员在其属性更改权限方面受到限制。下列属性只能由 dc_admin 更改：

@new_name
@target
@proxy_id
@description
@collection_mode
@days_until_expiration

示例

A. 重命名收集组

下面的示例重命名用户定义的收集组。

USE msdb;
GO
EXECUTE dbo.sp_syscollector_update_collection_set
@name = N'Simple collection set test 1',
@new_name = N'Collection set test 1 in cached mode';
GO

B. 将收集模式从非缓存模式更改为缓存模式

下面的示例将收集模式从非缓存模式更改为缓存模式。此更改需要您指定计划 ID 或计划名称。

USE msdb;
GO
EXECUTE dbo.sp_syscollector_update_collection_set
@name = N'Collection set test 1 in cached mode',
@collection_mode = 0,
@schedule_uid = 'C7022AF3-51B8-4011-B159-64C47C88FF70';
-- alternatively, use @schedule_name.
-- @schedule_name = N'CollectorSchedule_Every_15min;
GO

C. 更改其他收集组参数

下面的示例更新名为“Simple collection set test 2”的收集组的各种属性。

USE msdb;
GO
EXEC dbo.sp_syscollector_update_collection_set
@name = N'Simple collection set test 2',
@collection_mode = 1,
@days_until_expiration = 5,
@description = N'This is a test collection set that runs in noncached mode.',
@logging_level = 0;
GO