Partager via


sp_syscollector_run_collection_set (Transact-SQL)

Démarre un jeu d'éléments de collecte si le collecteur est déjà activé et si le jeu d'éléments de collecte est configuré en mode de collecte sans mise en cache.

[!REMARQUE]

Cette procédure échouera si elle est exécutée sur un jeu d'éléments de collection configuré en mode de collecte mise en cache.

sp_syscollector_run_collection_set permet à un utilisateur de prendre des captures instantanées de données à la demande.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

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

Arguments

  • [ @collection_set_id = ] collection_set_id
    Identificateur local unique pour le jeu d'éléments de collection. collection_set_id est de type int et doit avoir une valeur si name a la valeur NULL.

  • [ @name = ] 'name'
    Nom du jeu d'éléments de collection. name est de type sysname et doit avoir une valeur si collection_set_id a la valeur NULL.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Notes

collection_set_id ou name doit avoir une valeur, tous deux ne pouvant avoir la valeur NULL.

Cette procédure démarre les travaux de collecte et de téléchargement pour le jeu d'éléments de collection spécifié, et démarre immédiatement le travail de l'agent de collecte si l'argument @collection_mode du jeu d'éléments de collection a la valeur 1 (mode non mis en cache). 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 d'éléments de collection sans planification.

Autorisations

Requiert l'appartenance au rôle de base de données fixe dc_operator (avec autorisation EXECUTE) pour exécuter cette procédure.

Exemple

Démarrez un jeu d'éléments de collection à l'aide de son identificateur.

USE msdb;
GO
EXEC sp_syscollector_run_collection_set @collection_set_id = 1

Voir aussi

Référence

Autres ressources