sp_syscollector_create_collection_set (Transact-SQL)

S’applique à :SQL Server

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.

Avertissement

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 de collection. name est sysname et ne peut pas être une chaîne vide ou NULL.

nom 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é pour une utilisation ultérieure. name est nvarchar(128) avec la valeur par défaut NULL.

[ @collection_mode = ] collection_mode Spécifie la façon dont les données sont collectées et stockées. collection_mode est smallint et peut avoir l’une des valeurs suivantes :

0 - Mode mis en cache. La collecte et le téléchargement de données sont sur des planifications séparées. Spécifiez le mode mis en cache pour la collecte continue.

1 - Mode non mis en cache. La collecte et le chargement des données sont planifiés de la même manière. Spécifiez le mode non mis en cache pour une collecte ad hoc ou par instantané.

La valeur par défaut pour collection_mode est 0. Lorsque collection_mode est égal à 0, schedule_uid ou schedule_name doivent être spécifiés.

[ @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 une valeur par défaut de 730 (deux ans). days_until_expiration doit être 0 ou un entier positif.

[ @proxy_id = ] proxy_idIdentificateur unique d’un compte proxy SQL Server Agent. proxy_id est int avec la valeur par défaut NULL. S’il est spécifié, 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 SQL Server Agent.

[ @proxy_name = ] 'proxy_name' Nom du compte proxy. proxy_name est sysname avec la valeur null par défaut. Si elle est spécifiée, 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 uniqueidentifier avec une valeur par défaut NULL. Si elle est spécifiée, schedule_name doit avoir la valeur NULL. Pour obtenir schedule_uid, interrogez la table système sysschedules.

Lorsque collection_mode est défini sur 0, schedule_uid ou schedule_name doivent être spécifiés. Lorsque collection_mode est défini sur 1, schedule_uid ou schedule_name est ignoré s’il est spécifié.

[ @schedule_name = ] 'schedule_name' Nom de la planification. schedule_name est sysname avec une valeur null par défaut. S’il est spécifié, 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 smallint avec l’une des valeurs suivantes :

0 - informations d’exécution du journal et événements SSIS qui suivent :

  • 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’avertissement de SSIS

2 - Journalisation de niveau 1 et informations détaillées sur les événements de SSIS

La valeur par défaut pour logging_level est 1.

[ @description = ] 'description' Description du jeu de collection. description est nvarchar(4000) avec la valeur par défaut NULL.

[ @collection_set_id = ] collection_set_id Identificateur local unique pour le jeu de collection. collection_set_id est int avec OUTPUT et est obligatoire.

[ @collection_set_uid = ] 'collection_set_uid' GUID du jeu de collection. collection_set_uid est uniqueidentifier avec OUTPUT avec une valeur par défaut NULL.

Codet de retour

0 (réussite) ou 1 (échec)

Remarques

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

Autorisations

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

Exemples

R. 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

Collecte de données
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)
Procédures stockées du collecteur de données (Transact-SQL)
syscollector_collection_sets (Transact-SQL)