Création de configurations de package

Article
12/15/2008

Mis à jour : 15 septembre 2007

Vous pouvez créer des configurations de package à l'aide de la boîte de dialogue Bibliothèque des configurations du package et de l'Assistant Configuration de package. (Pour accéder à ces outils, dans Business Intelligence Development Studio, dans le menu SSIS, cliquez sur Configurations du package.)

Remarque :
Pour mieux vous familiariser avec les concepts abordés dans cette section, consultez le Déploiement du didacticiel des packages et la Leçon 3 : Ajout de configurations au package du Didacticiel Création d'un package ETL simple.

Dans la boîte de dialogue Bibliothèque des configurations du package, vous pouvez activer l'utilisation de configurations par les packages, ajouter et supprimer des configurations et définir l'ordre par défaut dans lequel les configurations sont chargées.

Remarque :
Lorsque les configurations de package sont chargées dans l'ordre par défaut, le chargement s'effectue de haut en bas dans la liste figurant dans la boîte de dialogue Bibliothèque des configurations du package. Toutefois, au moment de l'exécution, il est possible que les configurations des packages ne soient pas chargées dans l'ordre par défaut. Les configurations des packages parents sont notamment chargées après les configurations d'autres types.

Lorsque les configurations de package sont chargées dans l'ordre par défaut, le chargement s'effectue de haut en bas dans la liste figurant dans la boîte de dialogue Bibliothèque des configurations du package. Toutefois, au moment de l'exécution, il est possible que les configurations des packages ne soient pas chargées dans l'ordre par défaut. Les configurations des packages parents sont notamment chargées après les configurations d'autres types.

À partir de la boîte de dialogue Bibliothèque des configurations du package, vous pouvez exécuter l'Assistant Configuration de package, qui vous guide à travers les étapes de création d'une configuration. Sur les pages de l'Assistant, vous choisissez un type de configuration, vous choisissez si vous souhaitez accéder directement à la configuration ou utiliser des variables d'environnement, et vous sélectionnez les propriétés à enregistrer dans la configuration.

Remarque :
Si plusieurs configurations définissent la même propriété d'objet, la dernière valeur chargée est utilisée à l'exécution. Les exemples suivants illustrent les propriétés cibles d'une variable et d'un package telles qu'elles apparaissent dans la page Fin de l'Assistant de l'Assistant Configuration de package : \Package.Variables[User::TodaysDate].Properties[RaiseChangedEvent] \Package.Properties[MaximumErrorCount] \Package.Properties[LoggingMode] \Package.Properties[LocaleID] \Package\My SQL Task.Variables[User::varTableName].Properties[Value]

Si plusieurs configurations définissent la même propriété d'objet, la dernière valeur chargée est utilisée à l'exécution. Les exemples suivants illustrent les propriétés cibles d'une variable et d'un package telles qu'elles apparaissent dans la page Fin de l'Assistant de l'Assistant Configuration de package : \Package.Variables[User::TodaysDate].Properties[RaiseChangedEvent] \Package.Properties[MaximumErrorCount] \Package.Properties[LoggingMode] \Package.Properties[LocaleID] \Package\My SQL Task.Variables[User::varTableName].Properties[Value]

Les configurations mettent à jour les propriétés suivantes :

propriété RaiseChangedEvent de la variable définie par l'utilisateur TodaysDate ;
propriétés MaximumErrorCount, LoggingMode et LocaleID du package ;
propriété Value de la variable définie par l'utilisateur varTableName, dans la portée de la tâche My SQL Task.

La syntaxe « \Package » représente la racine, et les points (.) séparent les objets qui définissent le chemin d'accès de la propriété mise à jour par la configuration. Les noms de variables et de propriétés figurent entre crochets. Le terme Package est toujours utilisé dans la configuration, quel que soit le nom du package ; toutefois, tous les autres objets indiqués dans le chemin d'accès portent leur nom défini par l'utilisateur.

Une fois l'Assistant terminé, la nouvelle configuration est ajoutée à la liste des configurations dans la boîte de dialogue Bibliothèque des configurations du package.

Remarque :
La dernière page de l'Assistant Configuration de package, Fin de l'Assistant, répertorie les propriétés cibles dans la configuration. Si vous souhaitez mettre à jour des propriétés lors de l'exécution de packages à l'aide de l'utilitaire d'invite de commandes dtexec, vous pouvez générer les chaînes qui représentent les chemins d'accès aux propriétés en exécutant l'Assistant Configuration de package, puis les copier et les coller dans la fenêtre d'invite de commandes pour les utiliser avec l'option set de dtexec.

La dernière page de l'Assistant Configuration de package, Fin de l'Assistant, répertorie les propriétés cibles dans la configuration. Si vous souhaitez mettre à jour des propriétés lors de l'exécution de packages à l'aide de l'utilitaire d'invite de commandes dtexec, vous pouvez générer les chaînes qui représentent les chemins d'accès aux propriétés en exécutant l'Assistant Configuration de package, puis les copier et les coller dans la fenêtre d'invite de commandes pour les utiliser avec l'option set de dtexec.

Le tableau suivant décrit les colonnes dans la liste des configurations de la boîte de dialogue Bibliothèque des configurations du package.

Colonne	Description
Nom de configuration	Le nom de la configuration.
Type de configuration	Le type de la configuration.
Chaîne de configuration	L'emplacement de la configuration. L'emplacement peut être un chemin d'accès, une variable d'environnement, une clé de registre, un nom de variable d'un package parent ou une table d'une base de données SQL Server.
Objet cible	Le nom de l'objet dont une propriété a une configuration. Si la configuration est un fichier de configuration XML, la colonne est vide, car la configuration peut mettre à jour plusieurs objets.
Propriété cible	Nom de la propriété. Si la configuration écrit dans un fichier de configuration XML ou dans une table SQL Server, la colonne est vide puisque la configuration peut mettre à jour plusieurs objets.

Pour créer une configuration de package

Procédure : créer une configuration de package

Voir aussi

Historique des modifications

Version	Historique
15 septembre 2007	Contenu modifié : Ajout d'une remarque sur le chargement des configurations des packages.
14 avril 2006	Contenu modifié : Ajout d'une remarque relative à l'application de plusieurs configurations au même objet.
5 décembre 2005	Contenu modifié : Remarque ajoutée sur l'utilisation de l'Assistant pour générer des chemins d'accès à des propriétés.

Création de configurations de package

Pour créer une configuration de package

Voir aussi

Concepts

Autres ressources

Aide et Informations

Historique des modifications

Ressources supplémentaires