Exemple de composant de suppression des doublons

Article
12/15/2008

L'exemple Remove Duplicates Component montre l'implémentation d'un composant de transformation de flux de données à sorties asynchrones. Les composants à sorties asynchrones reçoivent une mémoire tampon PipelineBuffer d'entrée et de sortie correspondant à l'entrée et à la sortie de l'objet. La mémoire tampon d'entrée contient des lignes fournies par des composants en amont. La mémoire tampon de sortie est vide et elle est remplie par le composant, en général avec les lignes provenant de la mémoire tampon d'entrée, durant un appel de la méthode ProcessInput. Quand toutes les lignes ont été reçues, elles sont triées, puis les lignes distinctes sont envoyées à une sortie et les lignes en double à l'autre sortie. Cet exemple n'est pas pris en charge sur la plateforme IA64.

Important :
Les exemples de code de programmation de flux de données Integration Services ont été conçus pour montrer les fonctionnalités de base à implémenter pour créer un composant de flux de données personnalisé. Les exemples n'incluent pas de prise en charge complète de la personnalisation dans l'éditeur avancé. Par exemple, vous ne pouvez pas utiliser l'éditeur avancé pour ajouter ou supprimer des entrées et des sorties ou pour configurer des colonnes. Les exemples sont fournis uniquement à titre éducatif. 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.

Les exemples de code de programmation de flux de données Integration Services ont été conçus pour montrer les fonctionnalités de base à implémenter pour créer un composant de flux de données personnalisé. Les exemples n'incluent pas de prise en charge complète de la personnalisation dans l'éditeur avancé. Par exemple, vous ne pouvez pas utiliser l'éditeur avancé pour ajouter ou supprimer des entrées et des sorties ou pour configurer des colonnes. Les exemples sont fournis uniquement à titre éducatif. 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.

Pour plus d'informations sur la création d'un composant à sorties asynchrones, consultez la rubrique de la documentation en ligne de SQL Server 2005 relative au développement d'un composant de transformation personnalisée à sorties asynchrones.

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 l'exemple de code.

Configuration requise

Cet exemple nécessite l'installation des composants suivants.

Microsoft Visual Studio 2005
Microsoft SQL Server 2005 Integration Services

Emplacement

Si les exemples de code ont été installés à l'emplacement par défaut, la version C# de l'exemple de code se trouve dans le dossier suivant :

C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Data Flow\RemoveDuplicates Component 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 dans le dossier Samples, procédez de la façon suivante pour le générer. Les exemples de projets sont configurés pour signer les assemblys au moment de la génération avec ce fichier de clé. Vous pouvez consulter les propriétés de signature dans l'onglet Signature de la boîte de dialogue Propriétés du projet.

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

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.

À l'invite de commandes, utilisez la commande cd (Change Directory) 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 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.

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.

À 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 dans Microsoft Visual Studio 2005

Dans le menu Fichier, cliquez sur Ouvrir, cliquez sur Projet et ouvrez le fichier RemoveDuplicates.sln dans le langage de programmation de votre choix.
Dans le menu Générer, cliquez sur Générer RemoveDuplicates pour générer le projet.

Installation de l'exemple

Cet exemple est fourni en Visual Basic et en C#. Pour distinguer les assemblys de chaque version de l'exemple, CS ou VB est ajouté à la fin du nom de l'assembly de sortie. Après avoir généré le composant, effectuez les étapes suivantes pour l'ajouter à une tâche de flux de données dans Business Intelligence Development Studio.

Pour copier le composant dans le dossier PipelineComponents

Ouvrez l'Explorateur Windows ou l'application de votre choix pour travailler dans le système de fichiers.
Copiez l'assembly (RemoveDuplicatesCS.dll ou RemoveDuplicatesVB.dll) dans le dossier PipelineComponents situé dans %system%\Program Files\Microsoft SQL Server\90\DTS.

Pour installer le composant dans le GAC (Global Assembly Cache) en faisant glisser l'assembly

Ouvrez l'Explorateur Windows ou l'application de votre choix pour travailler dans le système de fichiers.
Faites glisser l'assembly du dossier PipelineComponents vers le dossier dans lequel se trouve le GAC dans %system%\assembly.

Pour installer le composant dans le Global Assembly Cache (GAC) à l'aide de gacutil.exe

Ouvrez une fenêtre d'invite de commandes.
Tapez la commande suivante pour exécuter gacutil.exe et installer la version C# du composant dans le GAC :

gacutil.exe -iF "c:\Program Files\Microsoft Sql Server\90\DTS\PipelineComponents\RemoveDuplicatesCS.dll "

- ou -

Tapez la commande suivante pour exécuter gacutil.exe et installer la version Visual Basic du composant dans le GAC :

gacutil.exe -iF "c:\Program Files\Microsoft Sql Server\90\DTS\PipelineComponents\RemoveDuplicatesVB.dll "

Pour ajouter le composant à la boîte à outils

Ouvrez Business Intelligence Development Studio.
Cliquez avec le bouton droit sur la boîte à outils, puis cliquez sur Choisir les éléments.
Dans la boîte de dialogue Choisir des éléments de boîte à outils, cliquez sur l'onglet Éléments de flux de données SSIS.
Activez la case à cocher située en regard de votre composant, puis cliquez sur OK.

Remarque :

Si le composant ne figure pas dans la liste, cliquez sur Parcourir pour le rechercher. Dans ce cas, toutefois, il risque de ne pas s'installer correctement.

Remarque :
Si le composant ne figure pas dans la liste, cliquez sur Parcourir pour le rechercher. Dans ce cas, toutefois, il risque de ne pas s'installer correctement.

Une fois ces étapes effectuées, le composant est visible sous l'onglet Éléments de flux de données de la Boîte à outils, et vous pouvez l'ajouter à la tâche de flux de données dans le Concepteur SSIS.

Test de l'exemple

Après avoir ajouté le composant à une tâche de flux de données dans un package et établi une connexion avec un composant qui lui fournira des lignes, vous pouvez le configurer de la façon suivante dans le concepteur SSIS.

Pour configurer l'exemple de composant dans un package

Sélectionnez les colonnes à utiliser par le composant dans l'onglet Colonnes d'entrée de l'Éditeur avancé. Seules les colonnes sélectionnées sont transmises au composant suivant dans le flux de données. Pour déterminer si une ligne est identique à d'autres lignes, le contenu de chaque colonne est comparé à celui de la colonne correspondante.