Partager via


sp_syscollector_start_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 n’est pas en cours d’exécution. Si le collecteur n’est pas activé, activez le collecteur en exécutant sp_syscollector_enable_collector , puis utilisez cette procédure stockée pour démarrer un jeu de collections.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_syscollector_start_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 la valeur par défaut NULL. @collection_set_id doit avoir une valeur si @name est NULL.

[ @name = ] N'name'

Nom du jeu d'éléments de collecte. @name est sysname, avec la valeur par défaut NULL. @name doit avoir une valeur si @collection_set_id est NULL.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Notes

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

Cette procédure échoue lors de l’exécution sur un jeu de collections qui n’a pas de planification. Si le jeu de collections n’a pas de planification (car son mode collection est défini sur non mis en cache, par exemple), utilisez la procédure stockée sp_syscollector_run_collection_set pour démarrer le jeu de collections.

Cette procédure active les travaux de collecte et de chargement 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 mode de collecte défini sur mis en cache (0). Pour plus d’informations, consultez sp_syscollector_create_collection_set.

Si le jeu de collections ne contient aucun élément de collection, cette opération n’a aucun 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 requis.

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;