sp_syscollector_run_collection_set (Transact-SQL)

  • Artigo

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

Esse 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.

Convenções de sintaxe de Transact-SQL

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 coleta. @collection_set_id é int, com um padrão de NULL, e deve ter um valor se @name for NULL.

@name [ = ] N'nome'

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

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

Ou @collection_set_id ou @name deve 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 (Transact-SQL).

sp_sycollector_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

Inicia um conjunto de coleta usando seu identificador.

USE msdb;
GO
EXEC sp_syscollector_run_collection_set
    @collection_set_id = 1;

Conteúdo relacionado