Partager via


sp_syscollector_start_collection_set (Transact-SQL)

Démarre un jeu d'éléments de collecte si le collecteur est déjà activé et que le jeu d'éléments de collecte n'est pas en cours d'exécution. Si le collecteur n’est pas activé, activez-le en exécutant sp_syscollector_enable_collector, puis utilisez cette procédure stockée pour démarrer un jeu d’éléments de collecte.

Icône Lien de rubriqueConventions de syntaxe Transact-SQL

Syntaxe

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

Arguments

  • [ @collection\_set\_id = ] collection_set_id
    Identificateur local unique du jeu d'éléments de collecte. collection_set_id est de type int avec NULL comme valeur par défaut. collection_set_id doit avoir une valeur si la valeur de name est NULL.

  • [ @name = ] 'name'
    Nom du jeu d'éléments de collecte. name est de type sysname avec NULL comme valeur par défaut. name doit avoir une valeur si la valeur de collection_set_id est NULL.

Valeurs des codes de retour

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

Notes

sp_syscollector_create_collection_set doit être exécuté dans le contexte de la base de données système msdb et l'Agent SQL Server doit être activé.

Cette procédure échoue si elle est exécutée sur un jeu d'éléments de collecte sans planification. Si le jeu d'éléments de collecte n'a pas de planification (car il est défini en mode de collecte non mis en cache, par exemple), utilisez la procédure stockée sp_syscollector_run_collection_set pour le démarrer.

Cette procédure active 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 le mode de collecte a la valeur 0 (mis en cache). Pour plus d'informations, consultez sp_syscollector_create_collection_set.

Si le jeu d'éléments de collecte ne contient aucun élément de collecte, cette opération est sans effet. L'erreur 14685 est retournée en tant qu'avertissement.

Autorisations

Nécessite l'appartenance au rôle de base de données fixe dc_operator pour exécuter cette procédure. Si le jeu d'éléments de collecte n'a pas de compte proxy, l'appartenance au rôle serveur fixe sysadmin est requise.

Exemples

L'exemple suivant démarre un jeu d'éléments de collecte à l'aide de son identificateur.

USE msdb;
GO
EXEC sp_syscollector_start_collection_set @collection_set_id = 1;