Partager via


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) or 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.

sp_syscollector_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;