Créer des configurations de package
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, cliquez sur Configurations du package dans le menu SSIS de Outils de données SQL Server (SSDT).
[!REMARQUE]
Vous pouvez également accéder à la Bibliothèque des configurations du package, en cliquant sur le bouton de sélection (points de suspension) en regard de la propriété Configuration. La propriété Configuration apparaît dans la fenêtre des propriétés du package.
[!REMARQUE]
Des configurations sont disponibles pour le modèle de déploiement de package. Les paramètres sont utilisés à la place des configurations pour le modèle de déploiement de projet. Le modèle de déploiement de projet vous permet de déployer des projets Integration Services sur le serveur Integration Services. Pour plus d'informations sur les modèles de déploiement, consultez Déploiement de projets et de packages.
Dans la boîte de dialogue Bibliothèque des configurations du package, vous pouvez permettre aux packages d'utiliser des configurations, ajouter et supprimer des configurations et définir l'ordre souhaité dans lequel sont chargées les configurations.
[!REMARQUE]
Lorsque les configurations du package sont chargées dans l'ordre souhaité, le chargement est effectué du haut vers le bas de la liste affichée dans la boîte de dialogue Bibliothèques des configurations du package. Toutefois, au moment de l'exécution, il se peut que les configurations de package ne soient pas chargées dans l'ordre souhaité. Les configurations de package parent sont notamment chargées après les configurations d'autres types.
[!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.
À 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. Pour exécuter l'Assistant Configuration de package, ajoutez une nouvelle configuration dans la boîte de dialogue Bibliothèque des configurations du package ou modifiez une configuration existante. 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.
L'exemple suivant illustre 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]
Dans cet exemple, la configuration met à jour ces propriétés :
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.
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
Dans Outils de données SQL Server (SSDT), ouvrez le projet Integration Services contenant le package de votre choix.
Dans l'Explorateur de solutions, double-cliquez sur le package pour l'ouvrir.
Dans le concepteur SSIS, cliquez sur l'onglet Flux de contrôle, Flux de données, Gestionnaire d'événements ou Explorateur de package.
Dans le menu SSIS, cliquez sur Configurations du package.
Dans la boîte de dialogue Bibliothèque des configurations du package, sélectionnez Activer les configurations du package et cliquez sur Ajouter.
Sur la page d'accueil de l'Assistant Configuration de package, cliquez sur Suivant.
Sur la page Sélectionner le type de configuration, spécifiez le type de configuration, puis définissez les propriétés se rapportant au type de configuration. Pour plus d'informations, consultez Référence de l'interface utilisateur de l'Assistant Configuration de package.
Dans la page Sélectionner les propriétés à exporter, sélectionnez les propriétés des objets de package à inclure dans la configuration. Si le type de configuration ne prend en charge qu'une seule propriété, le titre de cette page de l'Assistant est Sélectionner la propriété cible. Pour plus d'informations, consultez Référence de l'interface utilisateur de l'Assistant Configuration de package.
[!REMARQUE]
Seuls les types de configuration Fichier de configuration XML et SQL Server prennent en charge l'inclusion de plusieurs propriétés dans une configuration.
Dans la page Fin de l'Assistant, tapez le nom de la configuration, puis cliquez sur Terminer.
Affichez la configuration dans la boîte de dialogue Bibliothèque des configurations du package.
Cliquez sur Fermer.
Ressources externes
Publication technique, Understanding Integration Services Package Configurations (en anglais), sur le site msdn.microsoft.com
Entrée de blog, Creating packages in code – Package Configurations, sur www.sqlis.com.
Entrée de blog, API Sample – Programmatically add a configuration file to a package, sur blogs.msdn.com.
|
.gif "Icône Integration Services (petite)")
Rester à jour avec Integration Services