Partilhar via


sp_syscollector_start_collection_set (Transact-SQL)

Aplica-se: SQL Server

Inicia um conjunto de coleta se o coletor já estiver habilitado e o conjunto de coleta não estiver em execução. Se o coletor não estiver habilitado, habilite-o executando sp_syscollector_enable_collector e use esse procedimento armazenado para iniciar um conjunto de coleta.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_syscollector_start_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. @collection_set_id deve ter um valor se @name for NULL.

@name [ = ] N'nome'

Nome do conjunto de coleta. @name é sysname, com um padrão de NULL. @name deve ter um valor se @collection_set_id for NULL.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_syscollector_create_collection_set deve ser executado no contexto do banco de dados do sistema e o msdb SQL Server Agent deve estar habilitado.

Esse procedimento falha quando executado em um conjunto de coleta que não tem um agendamento. Se o conjunto de coleta não tiver um agendamento (porque seu modo de coleta está definido como não armazenado em cache, por exemplo), use o procedimento armazenado sp_syscollector_run_collection_set para iniciar o conjunto de coleta.

Esse procedimento habilita 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 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 coleção, essa operação não terá 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 este procedimento. Se o conjunto de coleta não tiver uma conta proxy, será necessária a associação à função de servidor fixa sysadmin.

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;