sp_syscollector_run_collection_set (Transact-SQL)
Aplica-se:
SQL Server
Inicia um conjunto de coleta se o coletor já estiver habilitado e o conjunto de coleta estiver configurado para o modo de coleta não armazenado em cache.
Observação
Esse procedimento falhará se for executado em um conjunto de coleta configurado para o modo de coleta armazenado em cache.
sp_syscollector_run_collection_set Permite que um usuário tire instantâneos de dados sob demanda.
Convenções de sintaxe de Transact-SQL
Sintaxe
sp_syscollector_run_collection_set
[ [ @collection_set_id = ] collection_set_id ]
[ , [ @name = ] N'name' ]
[ ; ]
Argumentos
@collection_set_id [ = ] collection_set_id
O identificador local exclusivo para o conjunto de coleta.
@collection_set_id é int, com um padrão de NULL, e deve ter um valor se @name for NULL.
[ @name = ] N'name'
Nome do conjunto de coleta.
@name é sysname, com um padrão de NULL, e deve ter um valor se @collection_set_id for NULL.
Valores do código de retorno
0 (sucesso) ou 1 (falha).
Comentários
Tanto @collection_set_id quanto @name devem ter um valor, ambos não podem ser NULL.
Este procedimento inicia os trabalhos de coleta e upload para o conjunto de coleta especificado e inicia imediatamente o trabalho do agente de coleta se o conjunto de coleta tiver seu @collection_mode definido como não armazenado em cache (1). Para obter mais informações, consulte sp_syscollector_create_collection_set.
sp_syscollector_run_collection_set Também pode ser usado para executar um conjunto de coleta que não tem um agendamento.
Permissões
Requer associação na função de banco de dados fixa dc_operator (com permissão EXECUTE) para executar este procedimento.
Exemplos
Inicia um conjunto de coleta usando seu identificador.
USE msdb;
GO
EXEC sp_syscollector_run_collection_set
@collection_set_id = 1;