Exemple de package Create DataFlow

Mis à jour : 5 décembre 2005

L'exemple de package Create DataFlow démontre comment créer un package et ajouter un flux de données par programme. Le package créé dans cet exemple effectue les actions suivantes :

• Extraction des données à partir de la table Products de la base de données AdventureWorks.
• Création d'une variable afin d'identifier la colonne utilisée pour trier la sortie.
• Enregistrement des résultats dans une destination de fichier plat.
• Exécution du package en mémoire.
• Enregistrement du package pour consultation ultérieure.

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.

Exécution de l'exemple

Si vous savez déjà commencer localiser, générer et installer les exemples de code, vous pouvez vous rendre directement à la section Test de l'exemple pour savoir comment configurer et exécuter cet exemple de code. Si vous n'avez pas utilisé les exemples de code avant, passez d'abord en revue la configuration requise.

Configuration requise

Avant d'exécuter cet exemple de code, assurez-vous que les conditions suivantes sont respectées :

• Ouvrez le Gestionnaire de configuration SQL Server. Dans le menu Démarrer, pointez successivement sur Tous les programmes, Microsoft SQL Server 2005 et Outils de configuration, puis cliquez sur Gestionnaire de configuration SQL Server.
• . Développez Configuration du réseau SQL Server 2005. Sélectionnez Protocoles pour MSSQLServer. Cliquez avec le bouton droit sur TCP/IP, puis cliquez sur Activer. Arrêtez le service, puis redémarrez-le. Pour plus d'informations, consultez « Procédure : définir les propriétés du service Integration Services à l'aide du composant logiciel enfichable Services » dans la documentation en ligne de SQL Server.
  ou
  Ouvrez le fichier main.cs et remplacez la valeur localhost affectée au paramètre Source dans adventureWorks.ConnectionString par le nom de votre serveur.
• L'exemple de code et ses données associées doivent d'abord être installés sur le disque dur local. Pour plus d'informations, consultez « Installation et compilation d'exemples de programmation Integration Services » dans la documentation en ligne de SQL Server.
• Vous devez disposer d'une connexion et d'autorisations administratives sur la base de données AdventureWorks. Pour plus d'informations, consultez « Installation de l'exemple de base de données AdventureWorks et des exemples » dans la documentation en ligne de SQL Server.

Pour compiler les exemples de code, il vous faut le Kit de développement .NET Framework SDK 2.0 ou Microsoft Visual Studio 2005. Vous pouvez vous procurer gratuitement le Kit de développement .NET Framework SDK. Consultez la rubrique de la documentation en ligne, Installation du SDK .NET Framework.

Emplacement

Si l'exemple de code a été installé à l'emplacement par défaut, l'exemple se trouve dans le répertoire suivant :

C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Control Flow\CreatePackage Sample

La solution C# pour l'exemple de code se trouve dans le répertoire CS et la solution Visual Basic dans le répertoire VB.

Pour obtenir des informations sur la procédure à deux étapes que vous devez suivre pour installer les exemples, consultez Installation des exemples. Pour vous procurer la dernière version des exemples, y compris les nouveaux exemples publiés après la version d'origine de SQL Server 2005, consultez Exemples et exemples de base de données SQL Server 2005 (avril 2006).

Génération de l'exemple

Si vous n'avez pas encore généré de fichier de clé de nom fort, procédez de la façon suivante pour le générer.

Pour générer un fichier de clé de nom fort

1. Pour ouvrir une invite de commandes de Microsoft Visual Studio 2005, cliquez sur Démarrer, pointez successivement sur Tous les programmes, sur Microsoft Visual Studio 2005 et sur Outils Visual Studio, puis cliquez sur Invite de commandes de Visual Studio 2005.

   - ou -

   Pour ouvrir une invite de commandes de Microsoft .NET Framework, cliquez sur Démarrer, pointez sur Tous les programmes et sur Microsoft .NET Framework SDK 2.0, puis cliquez sur Invite de commandes du Kit de développement SDK.

2. À l'invite de commandes, utilisez la commande CD (changer de répertoire) pour remplacer le dossier actif de la fenêtre d'invite de commandes par le dossier Samples. Le fichier de clé que vous créez dans ce dossier sera utilisé par tous les exemples de code Microsoft SQL Server 2005.

   Remarque :
   Pour déterminer le dossier dans lequel se trouvent les exemples, cliquez sur Démarrer, pointez successivement sur Tous les programmes, sur Microsoft SQL Server 2005 et sur Documentation et didacticiels, puis cliquez sur le répertoire Samples. Si l'emplacement d'installation par défaut a été utilisé, les exemples se trouvent dans <lecteur_système>:\Program Files\Microsoft SQL Server\90\Samples.

3. À l'invite de commandes, exécutez la commande suivante pour générer le fichier de clé :

   sn -k SampleKey.snk

Important :
Pour plus d'informations sur la paire de clés de nom fort, consultez l'article de sécurité concernant les noms forts et la sécurité dans .NET Framework, dans le Centre de développement .NET sur MSDN.

Pour générer l'exemple

1. Ouvrez Microsoft Visual Studio 2005.

2. Dans le menu Fichier, cliquez sur Ouvrir, cliquez sur Projet et ouvrez le fichier de solution (.sln) correspondant à l'exemple souhaité (en l'occurrence le fichier CreatePackageCS.sln) à partir du dossier CS ou du dossier VB, selon le langage de programmation que vous voulez utiliser.

3. Cliquez sur Générer / Générer CreateTask*<lang>* dans le menu.

Test de l'exemple

Lorsque l'exemple de code est exécuté, le package créé par programme est exécuté en mémoire et enregistré sur l'ordinateur local.

Vous pouvez consulter la version enregistrée du package créée par cet exemple de code en ouvrant le package dans le concepteur SSIS. Pour plus d'informations sur l'ouverture d'un package dans le concepteur SSIS, consultez la rubrique : « Procédure : ajouter un projet Integration Services existant à une solution », dans la documentation en ligne SQL Server 2005.

Le package est enregistré à l'emplacement suivant :

C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Control Flow\CreatePackage Sample\<langage>\CreatePackage\bin\Debug\SampleRuntimePackage.dtsx

Les résultats créés par le package sont enregistrés à l'emplacement suivant :

C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\ \Programming Samples\Control Flow\CreatePackage Sample\<langage>\CreatePackage\bin\Debug\SampleRuntimeData.txt

Vous pouvez vérifier si l'exécution du package a réussi en examinant les résultats dans le fichier plat de destination. La colonne spécifiée par la variable SortColumn détermine comment les résultats sont triés. Toute exécution ultérieure de l'exemple remplacera à la fois le package enregistré et les résultats précédents dans le fichier plat

Durant l'exécution, des informations sur l'état du package (y compris le nombre de lignes écrites) sont envoyées à la console. Voici un exemple des informations envoyées vers la console.

OnInformation

SubComponent: DTS.Pipeline

Description: "component "FlatFileDestination" (221)" wrote 504 rows.

Historique des modifications

Version	Historique
17 juillet 2006	Contenu modifié : Ajout d'informations détaillées supplémentaires pour l'exécution et le test du package ; description des résultats attendus.