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.

Convenções da 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 de 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 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 o procedimento. Se o conjunto de coleta não tiver uma conta proxy, a associação na 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

Referência

Procedimentos armazenados de coletor de dados (Transact-SQL)

syscollector_collection_sets (Transact-SQL)

Conceitos

Coleta de dados