sp_syscollector_start_collection_set (Transact-SQL)

  • Article

S’applique à :SQL Server

Démarre un jeu de collection si le collecteur est déjà activé et que le jeu de collection 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 collection.

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 pour le jeu de collection. @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) ou 1 (échec).

Notes

sp_syscollector_create_collection_setdoit ê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 collection qui n’a pas de planification. Si le jeu de collections n’a pas de planification (car son mode de 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 collection.

Cette procédure active les travaux de collecte et de chargement pour l’ensemble de collection spécifié, et démarre immédiatement le travail de l’agent de collection si le mode de collecte est défini sur mis en cache (0). Pour plus d’informations, consultez sp_syscollector_create_collection_set.

Si le jeu de collection 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 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;

Voir aussi