sp_syscollector_run_collection_set (Transact-SQL)

  • Artículo

Se aplica a:SQL Server

Inicia un conjunto de recopilación si el recopilador ya está habilitado y el conjunto de recopilación está configurado para el modo de recopilación no almacenado en caché.

Nota:

Este procedimiento produce un error si se ejecuta en un conjunto de recopilación configurado para el modo de recopilación en caché.

sp_syscollector_run_collection_set permite al usuario tomar instantáneas de datos a petición.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_syscollector_run_collection_set
    [ [ @collection_set_id = ] collection_set_id ]
    [ , [ @name = ] N'name' ]
[ ; ]

Argumentos

[ @collection_set_id = ] collection_set_id

Identificador local único del conjunto de recopilación. @collection_set_id es int, con un valor predeterminado de NULLy debe tener un valor si @name es NULL.

[ @name = ] N'name'

Nombre del conjunto de recopilación. @name es sysname, con un valor predeterminado de NULLy debe tener un valor si @collection_set_id es NULL.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Comentarios

Tanto @collection_set_id como @name deben tener un valor, ambos no pueden ser NULL.

Este procedimiento inicia los trabajos de recopilación y carga del conjunto de recopilación especificado e inicia inmediatamente el trabajo del agente de recopilación si el conjunto de recopilación tiene su @collection_mode establecido en no almacenado en caché (1). Para obtener más información, consulte sp_syscollector_create_collection_set (Transact-SQL).

sp_sycollector_run_collection_set también se puede usar para ejecutar un conjunto de recopilación que no tenga una programación.

Permisos

Requiere la pertenencia al rol fijo de base de datos dc_operator (con permiso EXECUTE) para ejecutar este procedimiento.

Ejemplos

Iniciar un conjunto de recopilación mediante su identificador.

USE msdb;
GO
EXEC sp_syscollector_run_collection_set
    @collection_set_id = 1;

Contenido relacionado