sp_syscollector_run_collection_set (Transact-SQL)
Starts a collection set if the collector is already enabled and the collection set is configured for non-cached collection mode.
Note
This procedure will fail if it is run against a collection set that is configured for cached collection mode.
sp_syscollector_run_collection_set enables a user to take on-demand data snapshots.
.gif "Topic link icon")
Syntax
sp_syscollector_run_collection_set [[ @collection_set_id= ] collection_set_id ]
, [[ @name= ] 'name' ]
Arguments
[ @collection_set_id = ] collection_set_id
Is the unique local identifier for the collection set. collection_set_id is int and must have a value if name is NULL.[ @name = ] 'name'
Is the name of the collection set. name is sysname and must have a value if collection_set_id is NULL.
Return Code Values
0 (success) or 1 (failure)
Remarks
Either collection_set_id or name must have a value, both cannot be NULL.
This procedure will start the collection and upload jobs for the specified collection set and will immediately start the collection agent job if the collection set has its @collection_mode set to non-cached (1). For more information see, sp_syscollector_create_collection_set (Transact-SQL).
sp_sycollector_run_collection_set can also be used to run a collection set that does not have a schedule.
Permissions
Requires membership in the dc_operator (with EXECUTE permission) fixed database role to execute this procedure.
Example
Start a collection set using its identifier.
USE msdb;
GO
EXEC sp_syscollector_run_collection_set @collection_set_id = 1