Partager via


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.

Icône Lien de rubriqueConventions de 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é pour un usage futur. 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 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 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 capture instantanée.

    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 de type smallint, avec 730 (deux années) comme valeur par défaut. days_until_expiration doit être 0 ou un entier positif.

  • [ @proxy\_id = ] proxy_id
    Identificateur unique pour un compte proxy de l'Agent 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éation de proxys d'Agent SQL Server.

  • [ @proxy\_name = ] 'proxy_name'
    Nom du compte proxy. L'argument 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 sur 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 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 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. L'argument 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 et est requis.

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

Valeurs des codes de retour

0 (succès) 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 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 requis, mais le mode de collecte par défaut (mis en cache) nécessite de spécifier un ID 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;