다음을 통해 공유


sp_syscollector_delete_collection_item(Transact-SQL)

적용 대상: SQL Server

컬렉션 집합에서 컬렉션 항목을 삭제합니다.

Transact-SQL 구문 표기 규칙

구문

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

인수

[ @collection_item_id = ] collection_item_id

컬렉션 항목의 고유 식별자입니다. @collection_item_id 기본값NULLint입니다. @name 경우 @collection_item_id 값이 NULL있어야 합니다.

[ @name = ] N'name'

컬렉션 항목의 이름입니다. @name sysname이며 기본값은 빈 문자열입니다. @collection_item_id 경우 @name 값이 NULL있어야 합니다.

반환 코드 값

0(성공) 또는 1(실패).

설명

sp_syscollector_delete_collection_item 는 시스템 데이터베이스의 msdb 컨텍스트에서 실행되어야 합니다. 컬렉션 항목은 시스템 컬렉션 집합에서 삭제할 수 없습니다.

이 작업 중에 컬렉션 항목이 포함된 컬렉션 집합이 중지되고 다시 시작됩니다.

사용 권한

이 절차를 실행하려면 dc_admin 멤버 자격(EXECUTE 권한 포함) 고정 데이터베이스 역할이 필요합니다.

예제

다음 예에서는 MyCollectionItem1이라는 컬렉션 항목을 삭제합니다.

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