Exemple ADO Source Component

L'exemple ADO Source Component montre comment implémenter un composant source qui peut être utilisé en tant que source de données dans une tâche de flux de données. Ce composant utilise le gestionnaire de connexions ADO.NET pour acquérir une connexion à une base de données et exécute l'instruction SQL fournie par l'utilisateur. Les lignes obtenues suite à l'exécution de l'instruction sont ajoutées à un PipelineBuffer fourni au composant par la tâche de flux de données, puis sont mises à disposition des composants en aval. Cet exemple n'est pas pris en charge sur des systèmes d'exploitation Itanium.

Important :

Les exemples de code de programmation de flux de données Integration Services ont pour but de montrer les fonctionnalités principales à 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, ni pour configurer des colonnes. 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 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 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\Data Flow\Ado Source 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

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

1. Dans le menu Fichier, cliquez sur Ouvrir, cliquez sur Projet et ouvrez le fichier de solution AdoSource.sln dans le langage de programmation de votre choix.

2. Dans le menu Générer, cliquez sur Générer AdoSource pour générer le projet.

Installation de l'exemple

Cet exemple est fourni en Visual Basic et en C#. Pour effectuer la distinction entre les assemblys de chaque version de l'exemple, CS ou BV est ajouté à la fin du nom de l'assembly de sortie. Après avoir généré le composant, effectuez la procédure suivante pour l'utiliser dans Business Intelligence Development Studio.

Pour copier le composant dans le dossier PipelineComponents

1. Ouvrez l'Explorateur Windows ou l'application de votre choix pour travailler dans le système de fichiers.

2. Copiez l'assembly (AdoSourceCS.dll ou AdoSourceVB.dll) dans le dossier PipelineComponents situé à l'emplacement %system%\Program Files\Microsoft SQL Server\90\DTS.

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

1. Ouvrez l'Explorateur Windows ou l'application de votre choix pour travailler dans le système de fichiers.

2. 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

1. Ouvrez une fenêtre d'invite de commandes.

2. 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\AdoSourceCS.dll"

   - ou -

3. 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\AdoSourceVB.dll"

Pour ajouter le composant à la boîte à outils

1. Ouvrez Business Intelligence Development Studio.

2. Cliquez avec le bouton droit sur la boîte à outils, puis cliquez sur Choisir les éléments.

3. 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.

4. 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.

Une fois ces étapes terminées, le composant est visible dans la section Sources de flux de données de la boîte à outils et peut être ajouté à la tâche de flux de données dans le concepteur.

Test de l'exemple

Après avoir ajouté l'exemple de composant à une tâche de flux de données dans un package, vous pouvez le configurer comme suit dans le concepteur SSIS.

Pour configurer l'exemple de composant dans un package

1. Ajoutez un gestionnaire de connexions ADO.NET au package et sélectionnez le Fournisseur Microsoft OLE DB pour SQL Server. Configurez l'exemple de composant de façon à utiliser ce gestionnaire de connexions.

2. Dans la page Propriétés du composant de l'Éditeur avancé, sous Propriétés personnalisées, configurez la propriété personnalisée SqlStatement du composant en entrant une requête SQL valide sur des tables ou des vues dans la base de données avec laquelle le gestionnaire de connexions établit une connexion.