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';