Partilhar via


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.

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

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;