sp_syscollector_delete_collection_item (Transact-SQL)

适用范围:SQL Server

从集合集中删除集合项。

Transact-SQL 语法约定

语法

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';