Share via


sp_syscollector_start_collection_set (Transact-SQL)

Inicia un conjunto de recopilación si el recopilador ya está habilitado y el conjunto de recopilación no se está ejecutando. Si el recopilador no está habilitado, lo habilita ejecutando sp_syscollector_enable_collector y, a continuación, usa este procedimiento almacenado para iniciar un conjunto de recopilación.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_syscollector_start_collection_set 
    [ [ @collection_set_id = ] collection_set_id ]
    , [[ @name = ] 'name' ] 

Argumentos

  • [ @collection\_set\_id = ] collection_set_id
    Es el identificador único local del conjunto de recopilaciones. collection_set_id es de tipo int y su valor predeterminado es NULL. collection_set_id debe tener un valor si name es NULL.

  • [ @name = ] 'name'
    Es el nombre del conjunto de recopilación. name es de tipo sysname y su valor predeterminado es NULL. name debe tener un valor si collection_set_id es NULL.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

sp_syscollector_create_collection_set se debe ejecutar en el contexto de la base de datos del sistema msdb y el Agente SQL Server debe estar habilitado.

Este procedimiento producirá un error cuando se ejecute con un conjunto de recopilación que no tenga una programación. Si el conjunto de recopilación no tiene una programación (dado que su modo de recopilación se establece en no almacenado en caché, por ejemplo), use el procedimiento almacenado del sp_syscollector_run_collection_set para iniciar la recopilación establecida.

Este procedimiento habilita los trabajos de recopilación y carga para el conjunto de recopilación especificado e iniciará inmediatamente el trabajo del agente de recopilación si el conjunto de recopilación tiene su modo de recopilación establecido en sin caché (0). Para obtener más información, vea sp_syscollector_create_collection_set.

Si el conjunto de recopilación no contiene ningún elemento de recopilación, esta operación no tiene ningún efecto. Se devuelve el error 14685 como una advertencia.

Permisos

Requiere la pertenencia al rol fijo de base de datos dc_operator para ejecutar este procedimiento. Si el conjunto de recopilación no tiene una cuenta de proxy, es necesaria la pertenencia al rol fijo de servidor sysadmin.

Ejemplos

En el ejemplo siguiente se inicia un conjunto de recopilación mediante su identificador.

USE msdb;
GO
EXEC sp_syscollector_start_collection_set @collection_set_id = 1;

Vea también

Referencia

Procedimientos almacenados del recopilador de datos (Transact-SQL)

syscollector_collection_sets (Transact-SQL)

Conceptos

Recopilación de datos