sp_syscollector_delete_collection_item (Transact-SQL)

刪除收集組中的收集項。

適用於:SQL Server (SQL Server 2008 至目前版本)。

主題連結圖示 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';

請參閱

參考

sp_syscollector_create_collection_item (Transact-SQL)

資料收集器預存程序 (Transact-SQL)

syscollector_collection_items (Transact-SQL)

概念

資料收集