sp_syscollector_delete_collection_item (Transact-SQL)
适用于: (所有受支持的版本的 SQL Server)
从收集组中删除收集项。
语法
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)