sp_syscollector_delete_collection_item (Transact-SQL)

Exclui um item de coleta de um conjunto de coleta.

Convençõ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 o 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

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

Consulte também

Referência

sp_syscollector_create_collection_item (Transact-SQL)

Procedimentos armazenados de coletor de dados (Transact-SQL)

syscollector_collection_items (Transact-SQL)

Conceitos

Coleta de dados