sp_syscollector_run_collection_set (Transact-SQL)
S’applique à : SQL Server
Démarre un jeu de collections si le collecteur est déjà activé et que le jeu de collections est configuré pour le mode de collecte non mis en cache.
Remarque
Cette procédure échoue si elle est exécutée sur un jeu de collections configuré pour le mode de collecte mis en cache.
sp_syscollector_run_collection_set
permet à un utilisateur de prendre des instantanés de données à la demande.
Conventions de la syntaxe Transact-SQL
Syntaxe
sp_syscollector_run_collection_set
[ [ @collection_set_id = ] collection_set_id ]
[ , [ @name = ] N'name' ]
[ ; ]
Arguments
[ @collection_set_id = ] collection_set_id
Identificateur local unique du jeu de collections. @collection_set_id est int, avec une valeur par défaut NULL
, et doit avoir une valeur si @name est NULL
.
[ @name = ] N’name'
Nom du jeu d'éléments de collecte. @name est sysname, avec une valeur par défaut NULL
, et doit avoir une valeur si @collection_set_id est NULL
.
Valeurs des codes de retour
0
(réussite) ou 1
(échec).
Notes
@collection_set_id ou @name doit avoir une valeur, les deux ne peuvent pas être NULL
.
Cette procédure démarre la collection et charge les travaux pour le jeu de collections spécifié et démarre immédiatement le travail de l’agent de collecte si le jeu de collections a son @collection_mode défini sur non mis en cache (1
). Pour plus d’informations, consultez sp_syscollector_create_collection_set (Transact-SQL).
sp_sycollector_run_collection_set
peut également être utilisé pour exécuter un jeu de collections qui n’a pas de planification.
autorisations
Nécessite l’appartenance au rôle de base de données fixe dc_operator (avec l’autorisation EXECUTE) pour exécuter cette procédure.
Exemples
Démarrez un jeu d'éléments de collecte à l'aide de son identificateur.
USE msdb;
GO
EXEC sp_syscollector_run_collection_set
@collection_set_id = 1;