Configurations de package

Mis à jour : 17 juillet 2006

SQL Server 2005 Integration Services (SSIS) fournit des configurations de package avec lesquelles vous pouvez mettre à jour les valeurs des propriétés au moment de l'exécution. Une configuration est une paire propriété/valeur que vous ajoutez à un package terminé. En règle générale, vous devez créer un package, définir des propriétés sur les objets du package lors du développement de ce dernier, puis ajouter la configuration au package. Lors de son exécution, le package extrait les nouvelles valeurs de la propriété à partir de la configuration. Par exemple, lorsque vous utilisez une configuration, vous pouvez modifier la chaîne de connexion d'un gestionnaire de connexions ou mettre à jour la valeur d'une variable.

Les configurations de package offrent les avantages suivants :

  • Les configurations facilitent le déplacement des packages d'un environnement de développement vers un environnement de production. Par exemple, une configuration peut mettre à jour le chemin d'accès d'un fichier source ou bien modifier le nom d'une base de données ou d'un serveur.
  • Les configurations sont utiles lorsque vous déployez des packages sur de nombreux serveurs différents. Par exemple, une variable dans la configuration de chaque package déployé peut contenir une valeur d'espace disque différente, et si l'espace disque disponible ne correspond pas à cette valeur, le package ne s'exécute pas.
  • Les configurations rendent ces packages plus souples. Par exemple, une configuration peut mettre à jour la valeur d'une variable utilisée dans une expression de propriété.

Integration Services prend en charge différentes méthodes de stockage des configurations de package, telles que les fichiers XML, les tables d'une base de données SQL Server et les variables d'environnement et de package.

Chaque configuration est une paire propriété/valeur. Le fichier de configuration XML et les types de configuration SQL Server peuvent inclure plusieurs configurations.

Les configurations sont incluses lorsque vous créez un utilitaire de déploiement de package pour l'installation des packages. Lorsque vous installez les packages, les configurations peuvent être mises à jour lors d'une étape de l'installation du package.

ms141682.note(fr-fr,SQL.90).gifRemarque :
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.

Types de configuration des packages

Le tableau suivant décrit les types de configuration des packages.

Type Description

Fichier de configuration XML

Un fichier XML contient les configurations. Le fichier XML peut inclure plusieurs configurations.

Variable d'environnement

Une variable d'environnement contient la configuration.

Entrées de Registre

Une entrée de Registre contient la configuration.

Variable de package parent

Une variable dans le package contient la configuration. Ce type de configuration est généralement utilisé pour mettre à jour les propriétés dans les packages enfants.

Table SQL Server

Une table d'une base de données SQL Server contient la configuration. La table peut inclure plusieurs configurations.

Fichiers de configuration XML

Si vous sélectionnez le type de configuration Fichier de configuration XML, vous pouvez créer un nouveau fichier de configuration, réutiliser un fichier existant et ajouter de nouvelles configurations, ou réutiliser un fichier existant en remplaçant son contenu.

Un fichier de configuration XML est composé de deux sections :

  • Un en-tête qui contient des informations sur le fichier de configuration. Cet élément comprend des attributs tels que la date de création du fichier et le nom de la personne qui a généré le fichier.
  • Les éléments de configuration qui contiennent des informations sur chaque configuration. Cet élément comprend des attributs tels que le chemin d'accès de la propriété et la valeur configurée de la propriété.

Le code XML suivant présente la syntaxe d'un fichier de configuration XML. Cet exemple dévoile la configuration de la propriété Value d'une variable de type entier appelée MyVar.

<?xml version="1.0"?>
<DTSConfiguration>
   <DTSConfigurationHeading>
      <DTSConfigurationFileInfo
          GeneratedBy="DomainName\UserName"
          GeneratedFromPackageName="Package"
          GeneratedFromPackageID="{2AF06766-817A-4E28-9878-0DE37A150648}"
          GeneratedDate="2/01/2005 5:58:09 PM"/>
   </DTSConfigurationHeading>
   <Configuration ConfiguredType="Property" Path="\Package.Variables[User::MyVar].Value" ValueType="Int32">
      <ConfiguredValue>0</ConfiguredValue>
   </Configuration>
</DTSConfiguration>

Entrée de Registre

Si vous souhaitez utiliser une entrée de Registre pour stocker la configuration, vous pouvez utiliser une clé existante ou créer une nouvelle clé dans HKEY_CURRENT_USER. La clé de Registre que vous utilisez doit contenir une valeur nommée Value. Cette valeur peut être une chaîne ou une valeur DWORD.

Si vous sélectionnez le type de configuration Entrée de Registre, tapez le nom de la clé de registre dans la zone d'entrée de Registre. Le format est <clé de registre>. Si vous souhaitez utiliser une clé de registre qui n'est pas à la racine de HKEY_CURRENT_USER, utilisez le format <clé de registre\clé de registre\...> pour identifier la clé. Par exemple, pour utiliser la clé MyPackage située dans SSISPackages, tapez SSISPackages\MyPackage.

SQL Server

Si vous sélectionnez le type de configuration SQL Server, vous spécifiez la connexion à la base de données SQL Server dans laquelle vous voulez stocker les configurations. Vous pouvez enregistrer les configurations dans une table existante ou créer une nouvelle table dans la base de données spécifiée.

L'instruction SQL suivante montre l'instruction CREATE TABLE par défaut fournie par l'Assistant Configuration de package.

CREATE TABLE [dbo].[SSIS Configurations]
(
ConfigurationFilter NVARCHAR(255) NOT NULL,
ConfiguredValue NVARCHAR(255) NULL,
PackagePath NVARCHAR(255) NOT NULL,
ConfiguredValueType NVARCHAR(20) NOT NULL
)

Le nom que vous donnez à la configuration est la valeur stockée dans la colonne ConfigurationFilter.

Configurations directes et indirectes

Integration Services fournit des configurations directes et indirectes. Si vous spécifiez directement les configurations, Integration Services crée un lien direct entre l'élément de configuration et la propriété de l'objet package. Les configurations directes sont un meilleur choix lorsque l'emplacement de la source ne change pas. Par exemple, si vous êtes sûr que tous les déploiements dans le package utilisent le même chemin d'accès de fichier, vous pouvez spécifier un fichier de configuration XML.

Les configurations indirectes utilisent des variables d'environnement. Au lieu de spécifier directement le paramètre de configuration, la configuration pointe vers une variable d'environnement, qui contient à son tour la valeur de configuration. L'utilisation de configurations indirectes est un meilleur choix lorsque l'emplacement de la configuration peut changer pour chaque déploiement d'un package.

Voir aussi

Tâches

Création de configurations de package

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications

Version Historique

17 juillet 2006

Contenu modifié :
  • Ajout d'un lien au didacticiel décrivant comment créer et utiliser des configurations de package dans le cadre d'un déploiement.

14 avril 2006

Contenu modifié :
  • Ajout d'informations sur l'utilisation d'entrées du Registre en vue de stocker des configurations.