sp_syscollector_start_collection_set (Transact-SQL)
Inicia um conjunto de coleta se o coletor já estiver habilitado e o conjunto de coleta não estiver sendo executado. Se o coletor não estiver habilitado, habilite-o executando sp_syscollector_enable_collector e use este procedimento armazenado para iniciar um conjunto de coleta.
Sintaxe
sp_syscollector_start_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 com um valor padrão de NULL. collection_set_id deverá ter um valor, se name for NULL.[ @name = ] 'name'
É o nome do conjunto de coleta. name é sysname com um valor padrão NULL. name deverá ter um valor, se collection_set_id for NULL.
Valores de código de retorno
0 (êxito) ou 1 (falha)
Comentários
sp_syscollector_create_collection_set deve ser executado no contexto do banco de dados do sistema msdb e o SQL Server Agent deve estar habilitado.
Este procedimento falha quando executado em relação a um conjunto de coleta que não tem uma agenda. Se o conjunto de coleta não tiver uma agenda (por exemplo, porque seu modo de coleta está definido como não cache), use o procedimento armazenado sp_syscollector_run_collection_set para iniciá-lo.
Este procedimento habilita os trabalhos de carregamento e de coleta para o conjunto de coleta especificado e iniciará imediatamente o trabalho do agente de coleta, se o conjunto de coleta tiver seu modo de coleta definido como armazenado em cache (0). Para obter mais informações, consulte sp_syscollector_create_collection_set.
Se o conjunto de coleta não contiver nenhum item de coleta, essa operação não terá nenhum efeito. O erro 14685 é retornado como um aviso.
Permissões
Requer associação na função de banco de dados fixa dc_operator para executar esse procedimento. Se o conjunto de coleta não tiver uma conta proxy, a associação da função de servidor fixa sysadmin será necessária.
Exemplos
O exemplo a seguir inicia um conjunto de coleta usando seu identificador.
USE msdb;
GO
EXEC sp_syscollector_start_collection_set @collection_set_id = 1;
Consulte também