Bagikan melalui


sp_syscollector_delete_collection_item (T-SQL)

Berlaku untuk: SQL Server

Menghapus item koleksi dari kumpulan koleksi.

Konvensi sintaks transact-SQL

Sintaks

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

Argumen

[ @collection_item_id = ] collection_item_id

Pengidentifikasi unik untuk item koleksi. @collection_item_id int, dengan default NULL. @collection_item_id harus memiliki nilai jika @name adalah NULL.

[ @name = ] N'name'

Nama item koleksi. @name adalah sysname, dengan default string kosong. @name harus memiliki nilai jika @collection_item_id adalah NULL.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

sp_syscollector_delete_collection_item harus dijalankan dalam konteks msdb database sistem. Item koleksi tidak dapat dihapus dari kumpulan kumpulan sistem.

Kumpulan koleksi yang berisi item koleksi dihentikan dan dimulai ulang selama operasi ini.

Izin

Memerlukan keanggotaan dalam peran database tetap dc_admin (dengan izin EXECUTE) untuk menjalankan prosedur ini.

Contoh

Contoh berikut menghapus item koleksi bernama MyCollectionItem1.

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