Exemple de package Calculated Columns

Article
12/15/2008

L'exemple Calculated Columns est un package qui traite des transactions de vente archivées. Il utilise une source OLE DB, deux transformations de colonnes dérivées, une transformation de tri et une transformation d'agrégation. Les résultats sont envoyés vers un fichier plat au moyen d'une destination de fichier plat.

L'exemple de package Calculated Columns illustre comment extraire des données d'une table, effectuer des opérations mathématiques sur les données, agréger des valeurs de données, trier des données et écrire des données dans un fichier. Il utilise également une configuration de package, une variable et une expression de propriété pour effectuer une mise à jour dynamique de l'emplacement du fichier dans lequel il écrit et pour copier le fichier à cet emplacement.

Si vous exécutez l'exemple sur une version non anglaise de Windows, vous devrez peut-être remplacer le nom traduit du dossier Program Files pour pouvoir ouvrir ou exécuter l'exemple.

Important :
Les exemples sont fournis à titre éducatif uniquement. Ils ne sont pas destinés à être utilisés dans un environnement de production et n'ont pas été testés à cet usage. Microsoft ne fournit aucun support technique pour ces exemples.

Configuration requise

L'exécution de cet exemple de package nécessite les éléments suivants :

Les exemples de fichiers de données et de package qu'il utilise doivent être installés sur le lecteur de disque dur local.
Vous devez disposer d'une connexion et d'autorisations administratives sur la base de données AdventureWorks. Cet exemple récupère des données à partir de la table TransactionHistoryArchive de l'exemple de base de données AdventureWorks. Par défaut, cette table est installée avec la base de données AdventureWorks.
Si vous envisagez uniquement d'exécuter l'exemple de package à partir de la ligne de commande, vous devez installer SQL Server 2005 Integration Services (SSIS).
Si vous envisagez d'ouvrir le package dans le Concepteur SSIS et d'exécuter l'exemple de package, vous devez installer Business Intelligence Development Studio.

Pour plus d'informations sur l'installation des exemples, consultez la rubrique « Installation des exemples de packages Integration Services » dans la documentation en ligne de SQL Server. Pour vous procurer la dernière version des exemples, y compris les nouveaux exemples publiés depuis la version d'origine de SQL Server 2005, consultez Exemples et exemples de base de données SQL Server 2005 (avril 2006).

Emplacement de l'exemple de package

Si les exemples ont été installés à l'emplacement d'installation par défaut, l'exemple de package Calculated Columns se trouve dans le dossier suivant :

C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Package Samples\CalculatedColumns Sample\CalculatedColumns\.

Les fichiers suivants sont nécessaires à l'exécution de ce package.

Fichier	Description
CalculatedColumns.dtsx	Exemple de package.
results.txt	Données de l'exemple de fichier plat.

Exécution de l'exemple

Le package peut être exécuté à partir de la ligne de commande à l'aide de l'utilitaire dtexec ou exécuté dans Business Intelligence Development Studio.

Si vous utilisez une version non anglaise de Windows, vous devrez sans doute mettre à jour la propriété ConnectionString des gestionnaires de connexions de fichiers utilisés dans le package pour pouvoir exécuter l'exemple de package. Vérifiez que le chemin d'accès utilisé dans le gestionnaire de connexions est valide sur votre ordinateur et, le cas échéant, modifiez le chemin d'accès pour utiliser le nom traduit du dossier Program Files.

Pour cet exemple, il est possible que vous deviez mettre à jour « Program Files » dans la propriété ConnectionString du gestionnaire de connexions results.txt.

Pour exécuter le package avec dtexec

Ouvrez une fenêtre d'invite de commandes.
Utilisez la commande Changer de répertoire, cd, pour accéder au répertoire C:\Program Files\Microsoft SQL Server\90\DTS\Binn, l'emplacement de dtexec.

Tapez la commande suivante :

dtexec /f "C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Package Samples\CalculatedColumns Sample\CalculatedColumns\CalculatedColumns.dtsx"

Appuyez sur Entrée.

Pour plus d'informations sur l'exécution du package à l'aide de l'utilitaire dtexec, consultez la rubrique « Utilitaire dtexec » dans la documentation en ligne de SQL Server 2005.

Pour exécuter le package dans Business Intelligence Development Studio

Ouvrez Business Intelligence Development Studio.
Dans le menu Fichier, pointez sur Ouvrir, puis cliquez sur Projet/Solution.
Recherchez le dossier CalculatedColumns Sample, puis double-cliquez sur le fichier nommé CalculatedColumns.sln.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur CalculatedColumns.dtsx dans le dossier Packages SSIS, puis cliquez sur Exécuter le package.

Composants de l'exemple

Le tableau suivant répertorie les tâches, conteneurs, sources et destinations de données et transformations utilisés dans l'exemple.

Élément	Fonction
Tâche de flux de données	La tâche de flux de données, Calculate Values, exécute le flux de données du package.
Tâche de système de fichiers	La tâche de système de fichiers, Copy File, copie results.txt à partir du dossier d'installation dans Program Files, un dossier auquel les utilisateurs n'ont en général pas d'accès en écriture, vers le dossier Temp de l'utilisateur.
Source OLE DB	Le premier composant du flux de données est une source OLE DB nommée Extract Data. Celle-ci charge les données sources de transactions de vente archivées à partir de la table TransactionHistoryArchive de la base de données AdventureWorks.
Transformation de colonnes dérivées	La première transformation de colonnes dérivées se nomme Calculate LineItemTotalCost. Cette transformation crée une colonne nommée LineItemTotalCost en multipliant la quantité par le coût pour chaque transaction de vente et en stockant le résultat dans la nouvelle colonne. Cette nouvelle colonne est ensuite ajoutée à chaque ligne de sortie.
Transformation d'agrégation	La transformation d'agrégation, Sum Quantity and LineItemTotalCost, groupe les données par la colonne ProductID et, pour chaque ProductID, calcule la somme de sa colonne Quantity en tant que colonne QuantitySum, puis calcule la somme de la colonne LineItemTotalCost en tant que colonne TotalCostByID.
Transformation de colonnes dérivées	La deuxième transformation de colonnes dérivées, Calculate Average Cost, ajoute une nouvelle colonne, AvgCostByID, à chaque ligne de sortie. La colonne contient la valeur TotalCostByID divisée par la valeur QuantitySum pour chaque ProductID.
Transformation de tri	La transformation de tri, Sort by ProductID, trie les résultats par la colonne ProductID.
Destination de fichier plat	La destination de fichier plat, Load Data, enregistre les données dans un fichier plat nommé results.txt.
Gestionnaire de connexions de fichiers	Les trois gestionnaires de connexions de fichiers connectent la source, la copie du fichier results.txt et le répertoire Temp.
Gestionnaire de connexions OLE DB	Le gestionnaire de connexions OLE DB, (local).AdventureWorks, établit une connexion à la base de données AdventureWorks sur le serveur local.

Résultats de l'exemple

Les résultats de l'exécution de l'exemple de package Calculated Columns sont enregistrés dans un fichier texte situé dans le répertoire temp. Pour rechercher le répertoire Temp sur votre ordinateur, cliquez sur Démarrer, sur Exécuter, tapez %temp%, puis cliquez sur OK. Cette action ouvre votre dossier temp. Dans ce dossier, recherchez et ouvrez le fichier results.txt. Le contenu de ce fichier doit correspondre à celui du fichier results.txt situé dans le dossier C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Package Samples\CalculatedColumns Sample\CalculatedColumns. Vous pouvez afficher ou imprimer ce fichier results.txt prérempli avant d'exécuter le package.