Leçon 5-2 : Activer et définir les configurations du package

Article
05/23/2023

S’applique à :SQL Server SSIS Integration Runtime dans Azure Data Factory

Au cours de cette tâche, vous convertissez le projet en modèle de déploiement de package et activez les configurations du package à l’aide de l’Assistant Configuration de package. Vous utilisez cet Assistant pour générer un fichier de configuration XML qui contient les paramètres de configuration de la propriété Directory du conteneur de boucles Foreach. La valeur de la propriété Directory est fournie par une nouvelle variable de niveau package que vous pouvez mettre à jour au moment de l’exécution. Vous remplissez également un dossier New Sample Data à utiliser pour le test.

Créer une variable de niveau package mappée à la propriété Directory

Sélectionnez l’arrière-plan de l’onglet Flux de contrôle dans le concepteur SSIS. Cette sélection permet de définir l’étendue de la variable que vous créez pour le package.
Dans le menu SSIS , sélectionnez Variables.
Dans la fenêtre Variables, sélectionnez l’icône Ajouter une variable.
Dans la zone Nom, entrez varFolderName.

Important

Les noms de variable respectent la casse.
Vérifiez que la zone Étendue affiche le nom du package de la leçon 5 (Lesson 5).
Définissez la valeur de la zone Type de données de la variable varFolderName à String.
Réaffichez l’onglet Flux de contrôle et double-cliquez sur le conteneur Foreach File in Folder .
Dans la page Collection de l’Éditeur de boucle Foreach, sélectionnez Expressions, puis le bouton de sélection (...).
Dans l’Éditeur d’expressions de la propriété, sélectionnez la liste Propriété, puis Directory.
Dans la zone Expression, sélectionnez le bouton de sélection (...).
Dans le Générateur d’expressions, développez le dossier Variables et paramètres et faites glisser la variable User::varFolderName vers la zone Expression.
Sélectionnez OK pour quitter le Générateur d’expressions.
Sélectionnez OK pour quitter l’Éditeur d’expressions de la propriété.
Sélectionnez OK pour quitter l’Éditeur de boucle Foreach.

Activer les configurations du package

Dans le menu Projet, sélectionnez Convertir en modèle de déploiement de package.
Sélectionnez OK dans l’invite d’avertissement et, une fois la conversion terminée, sélectionnez OK dans la boîte de dialogue Convertir en modèle de déploiement de package.
Sélectionnez l’arrière-plan de l’onglet Flux de contrôle dans le concepteur SSIS.
Dans le menu SSIS, sélectionnez Configurations du package.
Dans la boîte de dialogue Bibliothèque des configurations du package, sélectionnez Activer les configurations du package, puis Ajouter.
Dans la page d’accueil de l’Assistant Configuration de package, sélectionnez Suivant.
Dans la page Sélectionner le type de configuration , vérifiez que Type de configuration a la valeur Fichier de configuration XML.
Dans la page Sélectionner le type de configuration, sélectionnez Parcourir.
La boîte de dialogue Sélectionner l’emplacement du fichier de configuration s’ouvre et contient le dossier du projet.
Dans la boîte de dialogue Sélectionner l’emplacement du fichier de configuration, entrez SSISTutorial dans la zone Nom de fichier, puis sélectionnez Enregistrer.
Dans la page Sélectionner le type de configuration, sélectionnez Suivant.
Dans la page Sélectionner les propriétés à exporter, dans le volet Objets, développez Variables, varFolderName, Propriétés, puis sélectionnez Valeur.
Dans la page Sélectionner les propriétés à exporter, sélectionnez Suivant.
Dans la page Fin de l’Assistant, entrez un nom de configuration, par exemple Configuration du répertoire du tutoriel SSIS. Le nom de configuration s’affiche dans la boîte de dialogue Bibliothèque des configurations du package.
Sélectionnez Terminer.
Sélectionnez Fermer.
L’Assistant crée un fichier de configuration appelé SSISTutorial.dtsConfig, qui contient les paramètres de configuration pour la valeur (Value) de la variable, qui définit à son tour la propriété Directory de l’énumérateur.

Notes

Un fichier de configuration contient généralement des informations complexes sur les propriétés de package mais, dans le cadre de ce tutoriel, la seule information qui nous concerne doit se présenter comme suit :
```
<Configuration 
    ConfiguredType="Property"  
    Path="\Package.Variables[User::varFolderName].Properties[Value]" 
    ValueType="String">  
  <ConfiguredValue></ConfiguredValue>  
</Configuration>
```

Créer et remplir un nouveau dossier d’exemples de données

Dans l’Explorateur Windows, à la racine de votre lecteur (par exemple C:\), créez un dossier appelé Nouvel exemple de données.
Localisez les fichiers d'exemple sur votre ordinateur et copiez trois des fichiers du dossier.
Dans le dossier New Sample Data , collez les fichiers que vous venez de copier.

Passer à la tâche suivante

Étape 3 : Modifier la valeur de configuration de la propriété Directory