다음을 통해 공유

  • 아티클

sp_syscollector_delete_collection_item(Transact-SQL)

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

항목 링크 아이콘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';