sp_syscollector_run_collection_set (Transact-SQL)

Inicia um conjunto de coleta se o coletor já estiver habilitado e o conjunto de coleta estiver configurado para o modo de coleta sem armazenamento em cache.

ObservaçãoObservação

Este procedimento falhará se for executado em um conjunto de coleta configurado para o modo de coleta em cache.

sp_syscollector_run_collection_set permite que um usuário tire instantâneos de dados sob demanda.

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

Sintaxe

sp_syscollector_run_collection_set [[ @collection_set_id = ] collection_set_id ]
          , [[ @name = ] 'name' ] 

Argumentos

  • [ @collection_set_id = ] collection_set_id
    É o identificador local exclusivo do conjunto de coleta. collection_set_id é int e deve ter um valor se name for NULL.

  • [ @name = ] 'name'
    É o nome do conjunto de coleta. name é sysname e deve ter um valor se collection_set_id for NULL.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

collection_set_id ou name deve ter um valor, mas ambos não podem ser NULL.

Este procedimento iniciará a coleta e carregará os trabalhos para o conjunto de coleta especificado e imediatamente iniciará o trabalho do agente de coleta se @collection_mode do conjunto de coleta estiver definido para não executar armazenamento em cache (1). Para obter mais informações, consulte sp_syscollector_create_collection_set (Transact-SQL).

sp_sycollector_run_collection_set também pode ser usado para executar um conjunto de coleta que não tenha uma agenda.

Permissões

Para executar esse procedimento, é necessária a associação na função de banco de dados fixa dc_operator (com a permissão EXECUTE).

Exemplo

Inicia um conjunto de coleta usando seu identificador.

USE msdb;
GO
EXEC sp_syscollector_run_collection_set @collection_set_id = 1

Consulte também

Referência

Outros recursos