• Artigo

sp_syscollector_delete_collection_item (Transact-SQL)

Exclui um item de coleta de um conjunto de coleta.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

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

Argumentos

  • [ @collection\_item\_id = ] collection_item_id
    É o identificador exclusivo do item de coleta. collection_item_id é int com um padrão de NULL. collection_item_id deverá ter um valor, se name for NULL.

  • [ @name = ] 'name'
    É o nome do item de coleta. name é sysname com um valor padrão de NULL. name deverá ter um valor, se collection_item_id for NULL.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_syscollector_delete_collection_item deve ser executado no contexto do banco de dados do sistema msdb. Os itens de coleta não podem ser excluídos dos conjuntos de coletas 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 a permissão EXECUTE) para execução desse procedimento.

Exemplos

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

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