Compartir a través de


sp_syscollector_start_collection_set (Transact-SQL)

Inicia un conjunto de recopilaciones si el recopilador ya está habilitado y el conjunto de recopilaciones 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 una recopilación establecida.

Icono de vínculo a temasConvenciones 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 recopilación. 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 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)

Notas

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

Es preciso pertenecer a la función fija de la 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 a la función fija 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;