sp_syscollector_update_collection_set (Transact-SQL)
Permet de modifier les propriétés d'un jeu d'éléments de collecte définis par l'utilisateur ou de le renommer.
.gif "Icône Lien de rubrique")
Syntaxe
sp_syscollector_update_collection_set
[ [ @collection_set_id = ] collection_set_id ]
, [ [ @name = ] 'name' ]
, [ [ @new_name = ] 'new_name' ]
, [ [ @target = ] 'target' ]
, [ [ @collection_mode = ] collection_mode ]
, [ [ @days_until_expiration = ] days_until_expiration ]
, [ [ @proxy_id = ] proxy_id ]
, [ [ @proxy_name = ] 'proxy_name' ]
,[ [ @schedule_uid = ] 'schedule_uid' ]
,[ [ @schedule_name = ] 'schedule_uid' ]
, [ [ @logging_level = ] logging_level ]
, [ [ @description = ] 'description' ]
Arguments
[ @collection_set_id = ] collection_set_id
Identificateur local unique du 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 collection. name est de typesysname et doit avoir une valeur si collection_set_id a la valeur NULL.[ @new_name = ] 'new_name'
Nouveau nom pour le jeu d'éléments de collecte. new_name est de type sysname et, s'il est utilisé, ne peut pas être une chaîne vide. new_name doit être unique. Pour obtenir une liste de noms de jeu d'éléments de collecte actuels, interrogez la vue système syscollector_collection_sets.[ @target = ] 'target'
Réservé pour un usage futur.[ @collection_mode = ] collection_mode
Type de collecte de données à utiliser. collection_mode est de type smallintet peut prendre l'une des valeurs suivantes :0 - Mode mis en cache. La collecte et le téléchargement de données sont sur des planifications distinctes. Spécifiez le mode mis en cache pour la collecte continue.
1 - Mode non mis en cache. La collecte et le téléchargement de données sont sur la même planification. Spécifiez le mode non mis en cache pour une collecte ad hoc ou par instantané.
Lorsque vous passez du mode non mis en cache au mode mis en cache (0), vous devez également spécifier schedule_uid ou schedule_name.
[ @days_until_expiration= ] days_until_expiration
Nombre de jours pendant lesquels les données collectées sont enregistrées dans l'entrepôt de données de gestion. days_until_expiration est de type smallint. days_until_expiration doit être égal à 0 ou un entier positif.[ @proxy_id = ] proxy_id
Identificateur unique pour un compte d'agent proxy SQL Server. proxy_id est de type int.[ @proxy_name = ] 'proxy_name'
Nom du proxy. proxy_name est de type sysname et accepte les valeurs NULL.[ @schedule_uid = ] 'schedule_uid'
GUID qui pointe vers une planification. schedule_uid est de type uniqueidentifier et il est facultatif.Pour obtenir schedule_uid, interrogez la table système sysschedules.
Lorsque l'argument collection_mode a pour valeur 0, l'argument schedule_uid ou schedule_name doit être spécifié. Lorsque l'argument collection_mode a pour valeur 1, l'argument schedule_uid ou schedule_name n'est pas pris en compte s'il est spécifié.
[ @schedule_name = ] 'schedule_name'
Nom de la planification. schedule_name est de type sysname et accepte les valeurs NULL. S'il est spécifié, l'argument schedule_uid doit avoir la valeur NULL. Pour obtenir schedule_name, interrogez la table système sysschedules.[ @logging_level = ] logging_level
Niveau d'enregistrement. logging_level est de type smallint, avec l'une des valeurs suivantes :0 - Informations de l'exécution du journal et événements SSIS qui effectuent le suivi des éléments suivants :
Démarrage/arrêt de jeux d'éléments de collection
Démarrage/arrêt de packages
Informations sur l'erreur
1 - Enregistrement de niveau 0 et :
Statistiques d'exécution
Progression de la collection continuellement en cours d'exécution
Événements d'avertissements de SSIS
2 - Enregistrement de niveau 1 et informations sur l'événement détaillées de SSIS
La valeur par défaut de logging_level est 1.
[ @description = ] 'description'
Description du jeu d'éléments de collecte. description est de type nvarchar(4000).
Valeurs des codes de retour
0 (succès) ou 1 (échec)
Notes
sp_syscollector_update_collection_set doit être exécuté dans le contexte de la base de données système msdb.
collection_set_id ou name doit avoir une valeur, tous deux ne pouvant avoir la valeur NULL. Pour obtenir ces valeurs, interrogez la vue système syscollector_collection_sets.
Si le jeu d'éléments de collecte est en cours d'exécution, vous pouvez mettre à jour uniquement schedule_uid et description. Pour arrêter le jeu d'éléments de collecte, utilisez sp_syscollector_stop_collection_set.
Autorisations
Requiert l'appartenance au rôle de base de données fixe dc_admin ou dc_operator (avec autorisation EXECUTE) pour exécuter cette procédure. Même si dc_operator peut exécuter cette procédure stockée, les membres de ce rôle sont limités en ce qui concerne les propriétés qu'ils peuvent modifier. Les propriétés suivantes peuvent être modifiées uniquement par dc_admin :
@new_name
@target
@proxy_id
@description
@collection_mode
@days_until_expiration
Exemples
A. Modification du nom d'un jeu d'éléments de collecte
L'exemple suivant renomme un jeu d'éléments de collecte définis par l'utilisateur :
USE msdb;
GO
EXECUTE dbo.sp_syscollector_update_collection_set
@name = N'Simple collection set test 1',
@new_name = N'Collection set test 1 in cached mode';
GO
B. Passage du mode de collecte non mis en cache au mode de collecte mis en cache
L'exemple suivant passe du mode de collecte non mis en cache au mode de collecte mis en cache. Cette modification nécessite de spécifier un ID ou un nom de planification.
USE msdb;
GO
EXECUTE dbo.sp_syscollector_update_collection_set
@name = N'Collection set test 1 in cached mode',
@collection_mode = 0,
@schedule_uid = 'C7022AF3-51B8-4011-B159-64C47C88FF70';
-- alternatively, use @schedule_name.
-- @schedule_name = N'CollectorSchedule_Every_15min;
GO
C. Modification d'autres paramètres de jeu d'éléments de collecte
L'exemple suivant met à jour différentes propriétés du jeu d'éléments de collecte appelé « Simple collection set test 2 » :
USE msdb;
GO
EXEC dbo.sp_syscollector_update_collection_set
@name = N'Simple collection set test 2',
@collection_mode = 1,
@days_until_expiration = 5,
@description = N'This is a test collection set that runs in noncached mode.',
@logging_level = 0;
GO
Voir aussi