sp_syscollector_delete_collection_item (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 システムデータベースのコンテキストで実行する必要があります。コレクションアイテムは、システムコレクションセットから削除できません。

この操作が実行されている間、コレクションアイテムを含むコレクションセットは停止し、再開されます。

このプロシージャを実行するには、(EXECUTE 権限を持つ) dc_admin 固定データベースロールのメンバーシップが必要です。

次の例では、MyCollectionItem1 というコレクションアイテムを削除します。

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