sp_syscollector_delete_collection_item (Transact-SQL)

适用于:yes (所有受支持的版本的 SQL Server)

从收集组中删除收集项。

Topic link iconTransact-SQL 语法约定

语法

  
sp_syscollector_delete_collection_item [[ @collection_item_id = ] collection_item_id ]  
    , [[ @name = ] 'name' ]   

参数

[ @collection_item_id =] @collection_item_id
收集项的唯一标识符。 collection_item_id 的值为 int ,默认值为 NULL。 如果name为 NULL,则collection_item_id必须具有值。

[ @name =] "@name"
收集项的名称。 名称sysname ,默认值为 NULL。 如果collection_item_id为 NULL,则name必须具有值。

返回代码值

0 (成功) 或 1 (失败)

注解

sp_syscollector_delete_collection_item 必须在 msdb 系统数据库的上下文中运行。 不能从系统收集组中删除收集项。

在此操作期间,将停止并重新启动包含收集项的收集组。

权限

需要具有 dc_admin(拥有 EXECUTE 权限)固定数据库角色的成员身份才能执行此过程。

示例

下面的示例删除一个名为 MyCollectionItem1 的收集项。

USE msdb;  
GO  
EXEC sp_syscollector_delete_collection_item @name = 'MyCollectionItem1';  

另请参阅

“数据收集”
sp_syscollector_create_collection_item (Transact-SQL)
数据收集器存储过程 (Transact-SQL)
syscollector_collection_items (Transact-SQL)