Partilhar via


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;