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 collecte configuré en mode de collecte mise en cache.

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

Icône Lien de rubrique Conventions de la syntaxe 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 collecte. collection_set_id est de type int et doit avoir une valeur si name est NULL.

  • [ @name = ] 'name'
    Nom du jeu d'éléments de collecte. name est de type sysname 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, 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 collecte 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 collecte 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 collecte sans 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.

Exemple

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

Voir aussi

Référence

Procédures stockées système (Transact-SQL)

Concepts

Collecte de données