sp_syscollector_run_collection_set (Transact-SQL)
Aplica-se a:SQL Server
Inicia um conjunto de coleta se o coletor já estiver habilitado e o conjunto de coleta estiver configurado para o modo de coleta não armazenado em cache.
Observação
Este procedimento falhará se for executado em um conjunto de coleta configurado para o modo de coleta em cache.
sp_syscollector_run_collection_set
permite que um usuário tire instantâneos de dados sob demanda.
Transact-SQL convenções de sintaxe
Sintaxe
sp_syscollector_run_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 coleções.
@collection_set_id é int, com um padrão de NULL
, e deve ter um valor se @name for NULL
.
[ @name = ] N'nome'
O nome do conjunto de coleções.
@name é sysname, com um padrão de NULL
, e deve ter um valor se @collection_set_id for NULL
.
Valores de código de retorno
0
(sucesso) ou 1
(fracasso).
Comentários
Tanto @collection_set_id quanto @name devem ter um valor, ambos não podem ser NULL
.
Este procedimento inicia os trabalhos de coleta e carregamento para o conjunto de coleta especificado e inicia imediatamente o trabalho do agente de coleta se o conjunto de coleta tiver seu @collection_mode definido como não armazenado em cache (1
). Para obter mais informações, consulte sp_syscollector_create_collection_set.
sp_syscollector_run_collection_set
também pode ser usado para executar um conjunto de coleta que não tem uma agenda.
Permissões
Requer associação à função de banco de dados fixa dc_operator (com permissão EXECUTE) para executar este procedimento.
Exemplos
Inicie um conjunto de coleções usando seu identificador.
USE msdb;
GO
EXEC sp_syscollector_run_collection_set
@collection_set_id = 1;