Compartilhar via


sp_syscollector_delete_collection_item (Transact-SQL)

Aplica-se: SQL Server

Exclui um item de coleta de um conjunto de coleta.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

@collection_item_id [ = ] collection_item_id

O identificador exclusivo do item de coleção. @collection_item_id é int, com um padrão de NULL. @collection_item_id deve ter um valor se @name for NULL.

[ @name = ] N'name'

O nome do item de coleta. @name é sysname, com um padrão de uma string vazia. @name deve ter um valor se @collection_item_id for NULL.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_syscollector_delete_collection_item deve ser executado no contexto do banco de dados do msdb sistema. Os itens de coleção não podem ser excluídos dos conjuntos de coleta do sistema.

O conjunto de coleta que contém o item de coleta é interrompido e reiniciado durante esta operação.

Permissões

Requer associação na função de banco de dados fixa dc_admin (com permissão EXECUTE) para executar este procedimento.

Exemplos

O exemplo a seguir exclui um item de coleta denominado MyCollectionItem1.

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