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;