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'name'
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;