sp_syscollector_create_collection_set (Transact-SQL)

Crée un jeu d'éléments de collecte. Vous pouvez utiliser cette procédure stockée afin de créer un jeu d'éléments de collecte personnalisé pour la collecte de données.

Attention

Dans les cas où le compte Windows configuré en tant que proxy est non interactif ou correspond à un utilisateur interactif qui ne s'est pas encore connecté, le répertoire de profils n'existera pas et la création du répertoire intermédiaire échouera. Par conséquent, si vous utilisez un compte proxy sur un contrôleur de domaine, vous devez spécifier un compte interactif qui a été utilisé au moins une fois afin de garantir que le répertoire de profils a été créé.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_syscollector_create_collection_set 
      [ @name = ] '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_name' ]
    , [ [ @logging_level = ] logging_level ]
    , [ [ @description = ] 'description' ]
    , [ @collection_set_id = ] collection_set_id OUTPUT 
    , [ [ @collection_set_uid = ] 'collection_set_uid' OUTPUT ]

Arguments

• [ @name = ] 'name'
  Nom du jeu d'éléments de collecte. name est de type sysname et ne peut pas être une chaîne vide ni avoir la valeur NULL.

  name doit être unique. Pour obtenir une liste de noms de jeux d'éléments de collecte actuels, interrogez la vue système syscollector_collection_sets.

• [ @target = ] 'target'
  Réservée pour un usage ultérieur. name est de type nvarchar(128), avec NULL comme valeur par défaut.

• [ @collection\_mode = ] collection_mode
  Spécifie la manière dont les données sont recueillies et stockées. collection_mode est de type smallint et 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é.

  La valeur par défaut de collection_mode est 0. Lorsque collection_mode a pour valeur 0, schedule_uid ou schedule_name doit être spécifié.

• [ @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 smallint avec 730 comme valeur par défaut (deux ans). days_until_expiration doit être égal à 0 ou être un entier positif.

• [ @proxy\_id = ] proxy_id
  Identificateur unique pour un compte d'Agent proxy SQL Server. proxy_id est de type int, avec NULL comme valeur par défaut. S'il est spécifié, l'argument proxy_name doit avoir la valeur NULL. Pour obtenir proxy_id, interrogez la table système sysproxies. Le rôle de base de données fixe dc_admin doit avoir l'autorisation d'accéder au proxy. Pour plus d'informations, consultez Créer un proxy de SQL Server Agent.

• [ @proxy\_name = ] 'proxy_name'
  Nom du compte proxy. proxy_name est de type sysname, avec NULL comme valeur par défaut. S'il est spécifié, l'argument proxy_id doit avoir la valeur NULL. Pour obtenir proxy_name, interrogez la table système sysproxies.

• [ @schedule\_uid = ] 'schedule_uid'
  GUID qui pointe vers une planification. schedule_uid est de type uniqueidentifier, avec NULL comme valeur par défaut. S'il est spécifié, l'argument schedule_name doit avoir la valeur NULL. 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 avec NULL comme valeur par défaut. 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 de journalisation. 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 collecte

  • Démarrage/arrêt de packages

  • Informations sur l'erreur

  1 - Enregistrement de niveau 0 et :

  • Statistiques d'exécution

  • Progression de la collecte continuellement en cours d'exécution

  • Événements d'avertissements de SSIS

  2 - Enregistrement de niveau 1 et informations d'é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) avec NULL comme valeur par défaut.

• [ @collection\_set\_id = ] collection_set_id
  Identificateur local unique pour le jeu d'éléments de collecte. collection_set_id est de type int avec OUTPUT ; il est requis.

• [ @collection\_set\_uid = ] 'collection_set_uid'
  GUID pour le jeu d'éléments de collecte. collection_set_uid est de type uniqueidentifier, avec OUTPUT et avec NULL comme valeur par défaut.

Valeurs des codes de retour

0 (réussite) 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 .

Autorisations

L'exécution de cette procédure requiert l'appartenance au rôle de base de données fixe dc_admin (avec l'autorisation EXECUTE).

Exemples

A.Création d'un jeu d'éléments de collecte à l'aide de valeurs par défaut

L'exemple suivant crée un jeu d'éléments de collecte en spécifiant uniquement les paramètres requis. @collection\_mode n'est pas nécessaire, mais le mode de collecte par défaut (mis en cache) nécessite de spécifier un ID de planification ou un nom de planification.

USE msdb;
GO
DECLARE @collection_set_id int;
EXECUTE dbo.sp_syscollector_create_collection_set
    @name = N'Simple collection set test 1',
    @description = N'This is a test collection set that runs in non-cached mode.',
    @collection_mode = 1,
    @collection_set_id = @collection_set_id OUTPUT;
GO

B.Création d'un jeu d'éléments de collecte à l'aide de valeurs spécifiées

L'exemple suivant crée un jeu d'éléments de collecte en spécifiant des valeurs pour un grand nombre des paramètres.

USE msdb;
GO
DECLARE @collection_set_id int;
DECLARE @collection_set_uid uniqueidentifier;
SET @collection_set_uid = NEWID();
EXEC dbo.sp_syscollector_create_collection_set
    @name = N'Simple collection set test 2',
    @collection_mode = 0,
    @days_until_expiration = 365,
    @description = N'This is a test collection set that runs in cached mode.',
    @logging_level = 2,
    @schedule_name = N'CollectorSchedule_Every_30min',
    @collection_set_id = @collection_set_id OUTPUT,
    @collection_set_uid = @collection_set_uid OUTPUT;

Voir aussi

Tâches

Créer un jeu d'éléments de collecte personnalisé qui utilise le type de collecteur Requête T-SQL générique (Transact-SQL)

Référence

Procédures stockées du collecteur de données (Transact-SQL)

syscollector_collection_sets (Transact-SQL)

Concepts

Collecte de données