通过

  • 项目

sp_syscollector_delete_collection_item (Transact-SQL)

用于从收集组中删除收集项。

主题链接图标Transact-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'
    收集项的名称。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';