sp_syscollector_delete_collection_item (Transact-SQL)
适用范围:SQL Server
从集合集中删除集合项。
语法
sp_syscollector_delete_collection_item
[ [ @collection_item_id = ] collection_item_id ]
[ , [ @name = ] N'name' ]
[ ; ]
参数
[ @collection_item_id = ] collection_item_id
集合项的唯一标识符。 @collection_item_id为 int,默认值为 NULL
. 如果@name为 NULL
,则@collection_item_id必须具有值。
[ @name = ] N'name'
集合项的名称。 @name为 sysname,默认值为空字符串。 如果@collection_item_id为 ,则@nameNULL
必须具有值。
返回代码值
0
(成功)或 1
(失败)。
注解
sp_syscollector_delete_collection_item
必须在系统数据库的上下文 msdb
中运行。 无法从系统集合集中删除集合项。
在此操作期间,将停止并重新启动包含收集项的收集组。
权限
要求dc_admin(具有 EXECUTE 权限)固定数据库角色的成员身份才能执行此过程。
示例
下面的示例删除一个名为 MyCollectionItem1
的收集项。
USE msdb;
GO
EXEC sp_syscollector_delete_collection_item @name = 'MyCollectionItem1';