Procédure : implémenter une transformation de recherche en mode Cache complet à l'aide de la transformation du gestionnaire de connexions du cache

Vous pouvez configurer la transformation de recherche afin qu'elle utilise le mode Cache complet et un gestionnaire de connexions du cache. En mode Cache complet, le dataset de référence est chargé dans le cache avant l'exécution de la transformation de recherche.

Notes

Le gestionnaire de connexions du cache ne prend pas en charge les types de données de l'objet BLOB (Binary Large Object) DT_TEXT, DT_NTEXT et DT_IMAGE. Si le dataset de référence contient un type de données d'objet BLOB, le composant échoue lorsque vous exécutez le package. Vous pouvez utiliser l'Éditeur du gestionnaire de connexions du cache pour modifier des types de données de colonne. Pour plus d'informations, consultez Éditeur du gestionnaire de connexions du cache.

La transformation de recherche effectue des recherches en joignant les données des colonnes d'entrée d'une source de données connectée aux colonnes d'un dataset de référence. Pour plus d'informations, consultez Transformation de recherche.

Vous utilisez l'un des éléments suivants pour générer un dataset de référence :

  • Fichier cache (.caw)

    Vous configurez le gestionnaire de connexions du cache afin de lire les données d'un fichier cache existant.

  • Source de données connectée dans le flux de données

    Vous utilisez la transformation du cache pour écrire des données provenant d'une source de données connectée dans le flux de données dans un gestionnaire de connexions du cache. Les données sont toujours stockées en mémoire.

    Vous devez ajouter la transformation de recherche à un flux de données séparé. Cet ajout permet à la transformation du cache de renseigner le gestionnaire de connexions du cache avant l'exécution de la transformation de recherche. Les flux de données peuvent être dans le même package ou dans deux packages séparés.

    Si les flux de données sont dans le même package, utilisez une contrainte de précédence pour connecter les flux de données. Cette contrainte permet à la transformation du cache de s'exécuter avant l'exécution de la transformation de recherche.

    Si les flux de données sont dans des packages séparés, vous pouvez utiliser la tâche Exécuter le package pour appeler le package enfant à partir du package parent. Vous pouvez appeler plusieurs packages enfants en ajoutant plusieurs tâches Exécuter le package à une tâche Conteneur de séquences dans le package parent.

Vous pouvez partager le dataset de référence stocké dans le cache, entre plusieurs transformations de Recherche en utilisant l'une des méthodes suivantes :

  • Configurez les transformations de recherche dans un seul package afin qu'elles utilisent le même gestionnaire de connexions du cache.

  • Configurez les gestionnaires de connexions du cache des différents packages afin qu'ils utilisent le même fichier cache.

Pour plus d'informations, consultez les rubriques suivantes :

Pour obtenir une vidéo qui montre comment utiliser le gestionnaire de connexions du cache pour implémenter une transformation de recherche en mode Cache complet, consultez How to: Implement a Lookup Transformation in Full Cache Mode (SQL Server Video) (en anglais).

Pour implémenter une transformation de recherche en mode Cache complet dans un seul package en utilisant le gestionnaire de connexions du cache et une source de données dans le flux de données

  1. Dans Business Intelligence Development Studio, ouvrez un projet Integration Services, puis ouvrez un package.

  2. Sous l'onglet Flux de contrôle, ajoutez deux tâches de flux de données, puis connectez les tâches en utilisant un connecteur vert :

  3. Dans le premier flux de données, ajoutez une transformation du cache, puis connectez la transformation à une source de données.

    Configurez la source de données selon vos besoins.

  4. Double-cliquez sur la transformation du cache, puis dans l'Éditeur de transformation du cache, sur la page Gestionnaire de connexions, cliquez sur Nouveau pour créer un gestionnaire de connexions du cache.

  5. Cliquez sur l'onglet Colonnes de la boîte de dialogue Éditeur du gestionnaire de connexions du cache, puis spécifiez quelles colonnes sont les colonnes d'index à l'aide de l'option Position d'index.

    Pour les colonnes qui ne sont pas des index, la position d'index est 0. Pour les colonnes d'index, la position d'index est un nombre séquentiel, positif.

    Notes

    Lorsque la transformation de recherche est configurée pour utiliser un gestionnaire de connexions du cache, seules les colonnes d'index dans le dataset de référence peuvent être mappées avec des colonnes d'entrée. En outre, toutes les colonnes d'index doivent être mappées. Pour plus d'informations, consultez Éditeur du gestionnaire de connexions du cache.

  6. Pour enregistrer le cache dans un fichier, dans l'Éditeur du gestionnaire de connexions du cache, sous l'onglet Général, configurez le gestionnaire de connexions du cache en définissant les options suivantes :

    • Sélectionnez Utiliser le cache de fichier.

    • Pour Nom de fichier, tapez le chemin d'accès du fichier ou cliquez sur Parcourir pour sélectionner le fichier.

      Si vous tapez un chemin d'accès de fichier qui n'existe pas, le système crée le fichier lorsque vous exécutez le package.

    Notes

    Le niveau de protection du package ne s'applique pas au fichier cache. Si le fichier cache contient des informations sensibles, utilisez une liste de contrôle d'accès (ACL) pour restreindre l'accès à l'emplacement ou au dossier dans lequel vous stockez le fichier. Vous devez autoriser l'accès à certains comptes uniquement. Pour plus d'informations, consultez Contrôle de l'accès aux fichiers utilisés par des packages.

  7. Configurez la transformation du cache selon vos besoins. Pour plus d'informations, consultez Éditeur de transformation du cache (Page Gestionnaire de connexions) et Éditeur de transformation du cache (page Mappages).

  8. Dans le second flux de données, ajoutez une transformation de recherche, puis configurez la transformation en effectuant les tâches suivantes :

    1. Connectez la transformation de recherche au flux de données en faisant glisser un connecteur (la flèche verte ou rouge) à partir d'une source ou d'une transformation précédente vers la transformation de recherche.

      Notes

      Une transformation de recherche peut ne pas se valider si cette transformation se connecte à un fichier plat qui contient un champ Date vide. La validation de la transformation dépend si le gestionnaire de connexions pour le fichier plat a été configuré pour conserver des valeurs NULL. Pour garantir la validation de la transformation de recherche, dans l'Éditeur de source de fichier plat, dans la page Gestionnaire de connexions, sélectionnez l'option Conserver les valeurs NULL de la source comme valeurs NULL dans le flux de données.

    2. Double-cliquez sur la transformation source ou précédente pour configurer le composant.

    3. Double-cliquez sur la transformation de recherche, puis dans l'Éditeur de transformation de recherche, sur la page Général, sélectionnez Cache complet.

    4. Dans la zone Type de connexion, sélectionnez Gestionnaire de connexions du cache.

    5. Dans la liste Spécifier comment gérer les lignes sans entrées correspondantes, sélectionnez une option de gestion des erreurs.

    6. Sur la page Connexion, dans la liste Gestionnaire de connexions du cache, sélectionnez un gestionnaire de connexions du cache.

    7. Cliquez sur la page Colonnes, puis faites glisser au moins une colonne de la liste Colonnes d'entrée disponibles vers une colonne de la liste Colonnes de recherche disponibles.

      Notes

      La transformation de recherche mappe automatiquement les colonnes ayant le même nom et le même type de données.

      Notes

      Les types de données des colonnes doivent correspondre pour que les colonnes puissent être mappées. Pour plus d'informations, consultez Types de données d'Integration Services.

    8. Dans la liste Colonnes de recherche disponibles, sélectionnez des colonnes. Ensuite, dans la liste Opération de recherche, spécifiez si les valeurs des colonnes de recherche remplacent les valeurs des colonnes d'entrée ou sont écrites dans une nouvelle colonne.

    9. Pour configurer la sortie d'erreur, cliquez sur la page Sortie d'erreur et définissez les options de gestion des erreurs. Pour plus d'informations, consultez Éditeur de transformation de recherche (page Sortie d'erreur).

    10. Cliquez sur OK pour enregistrer vos modifications apportées à la transformation de recherche.

  9. Exécutez le package.

Pour implémenter une transformation de recherche en mode Cache complet dans deux packages en utilisant un gestionnaire de connexions du cache et une source de données dans le flux de données

  1. Dans Business Intelligence Development Studio, ouvrez un projet Integration Services, puis ouvrez deux packages.

  2. Sous l'onglet Flux de contrôle dans chaque package, ajoutez une tâche de flux de données.

  3. Dans le package parent, ajoutez une transformation du cache au flux de données, puis connectez la transformation à une source de données.

    Configurez la source de données selon vos besoins.

  4. Double-cliquez sur la transformation du cache, puis dans l'Éditeur de transformation du cache, sur la page Gestionnaire de connexions, cliquez sur Nouveau pour créer un gestionnaire de connexions du cache.

  5. Dans l'Éditeur du gestionnaire de connexions du cache, sous l'onglet Général, configurez le gestionnaire de connexions du cache en définissant les options suivantes :

    • Sélectionnez Utiliser le cache de fichier.

    • Pour Nom de fichier, tapez le chemin d'accès du fichier ou cliquez sur Parcourir pour sélectionner le fichier.

      Si vous tapez un chemin d'accès de fichier qui n'existe pas, le système crée le fichier lorsque vous exécutez le package.

    Notes

    Le niveau de protection du package ne s'applique pas au fichier cache. Si le fichier cache contient des informations sensibles, utilisez une liste de contrôle d'accès (ACL) pour restreindre l'accès à l'emplacement ou au dossier dans lequel vous stockez le fichier. Vous devez autoriser l'accès à certains comptes uniquement. Pour plus d'informations, consultez Contrôle de l'accès aux fichiers utilisés par des packages.

  6. Cliquez sur l'onglet Colonnes, puis spécifiez quelles colonnes sont les colonnes d'index à l'aide de l'option Position d'index.

    Pour les colonnes qui ne sont pas des index, la position d'index est 0. Pour les colonnes d'index, la position d'index est un nombre séquentiel, positif.

    Notes

    Lorsque la transformation de recherche est configurée pour utiliser un gestionnaire de connexions du cache, seules les colonnes d'index dans le dataset de référence peuvent être mappées avec des colonnes d'entrée. En outre, toutes les colonnes d'index doivent être mappées. Pour plus d'informations, consultez Éditeur du gestionnaire de connexions du cache.

  7. Configurez la transformation du cache selon vos besoins. Pour plus d'informations, consultez Éditeur de transformation du cache (Page Gestionnaire de connexions) et Éditeur de transformation du cache (page Mappages).

  8. Effectuez l'une des opérations suivantes pour renseigner le gestionnaire de connexions du cache utilisé dans le second package :

    • Exécutez le package parent.

    • Double-cliquez sur le gestionnaire de connexions du cache que vous avez créé à l'étape 4, cliquez sur Colonnes, sélectionnez les lignes, puis appuyez sur CTRL+C pour copier les métadonnées de colonne.

  9. Dans le package enfant, pour créer un gestionnaire de connexions du cache, cliquez avec le bouton droit dans la zone Gestionnaires de connexions, cliquez sur Nouvelle connexion, sélectionnez CACHE dans la boîte de dialogue Ajout d'un gestionnaire de connexions SSIS, puis cliquez sur Ajouter.

    La zone Gestionnaires de connexions apparaît au bas des onglets Flux de contrôle, Flux de données et Gestionnaires d'événements du concepteur Integration Services.

  10. Dans l'Éditeur du gestionnaire de connexions du cache, sous l'onglet Général, configurez le gestionnaire de connexions du cache afin de lire les données à partir du fichier cache que vous avez sélectionné en définissant les options suivantes :

    • Sélectionnez Utiliser le cache de fichier.

    • Pour Nom de fichier, tapez le chemin d'accès du fichier ou cliquez sur Parcourir pour sélectionner le fichier.

    Notes

    Le niveau de protection du package ne s'applique pas au fichier cache. Si le fichier cache contient des informations sensibles, utilisez une liste de contrôle d'accès (ACL) pour restreindre l'accès à l'emplacement ou au dossier dans lequel vous stockez le fichier. Vous devez autoriser l'accès à certains comptes uniquement. Pour plus d'informations, consultez Contrôle de l'accès aux fichiers utilisés par des packages.

  11. Si vous avez copié les métadonnées de colonne à l'étape 8, cliquez sur Colonnes, sélectionnez la ligne vide, puis appuyez sur CTRL+V pour coller les métadonnées de colonne.

  12. Ajoutez une transformation de recherche, puis configurez la transformation en effectuant les tâches suivantes :

    1. Connectez la transformation de recherche au flux de données en faisant glisser un connecteur (la flèche verte ou rouge) à partir d'une source ou d'une transformation précédente vers la transformation de recherche.

      Notes

      Une transformation de recherche peut ne pas se valider si cette transformation se connecte à un fichier plat qui contient un champ Date vide. La validation de la transformation dépend si le gestionnaire de connexions pour le fichier plat a été configuré pour conserver des valeurs NULL. Pour garantir la validation de la transformation de recherche, dans l'Éditeur de source de fichier plat, dans la page Gestionnaire de connexions, sélectionnez l'option Conserver les valeurs NULL de la source comme valeurs NULL dans le flux de données.

    2. Double-cliquez sur la transformation source ou précédente pour configurer le composant.

    3. Double-cliquez sur la transformation de recherche, puis sélectionnez Cache complet sur la page Général de l'Éditeur de transformation de recherche.

    4. Sélectionnez Gestionnaire de connexions du cache dans la zone Type de connexion.

    5. Sélectionnez une option de gestion des erreurs pour les lignes sans entrées correspondantes dans la liste Spécifier comment gérer les lignes sans entrées correspondantes.

    6. Sur la page Connexion, dans la liste Gestionnaire de connexions du cache, sélectionnez le gestionnaire de connexions du cache que vous avez ajouté.

    7. Cliquez sur la page Colonnes, puis faites glisser au moins une colonne de la liste Colonnes d'entrée disponibles vers une colonne de la liste Colonnes de recherche disponibles.

      Notes

      La transformation de recherche mappe automatiquement les colonnes ayant le même nom et le même type de données.

      Notes

      Les types de données des colonnes doivent correspondre pour que les colonnes puissent être mappées. Pour plus d'informations, consultez Types de données d'Integration Services.

    8. Dans la liste Colonnes de recherche disponibles, sélectionnez des colonnes. Ensuite, dans la liste Opération de recherche, spécifiez si les valeurs des colonnes de recherche remplacent les valeurs des colonnes d'entrée ou sont écrites dans une nouvelle colonne.

    9. Pour configurer la sortie d'erreur, cliquez sur la page Sortie d'erreur et définissez les options de gestion des erreurs. Pour plus d'informations, consultez Éditeur de transformation de recherche (page Sortie d'erreur).

    10. Cliquez sur OK pour enregistrer vos modifications apportées à la transformation de recherche.

  13. Ouvrez le package parent, ajoutez une tâche Exécuter le package au flux de contrôle, puis configurez la tâche afin d'appeler le package enfant. Pour plus d'informations, consultez Tâche d'exécution de package.

  14. Exécutez les packages.

Pour implémenter une transformation de recherche en mode Cache complet à l'aide d'un gestionnaire de connexions du cache et d'un fichier cache existant

  1. Dans Business Intelligence Development Studio, ouvrez un projet Integration Services, puis ouvrez un package.

  2. Cliquez avec le bouton droit dans la zone Gestionnaires de connexions et choisissez Nouvelle connexion.

    La zone Gestionnaires de connexions apparaît au bas des onglets Flux de contrôle, Flux de données et Gestionnaires d'événements du concepteur Integration Services.

  3. Dans la boîte de dialogue Ajout d'un gestionnaire de connexions SSIS, sélectionnez CACHE, puis cliquez sur Ajouter pour ajouter un gestionnaire de connexions du cache.

  4. Double-cliquez sur le gestionnaire de connexions du cache pour ouvrir l'Éditeur du gestionnaire de connexions du cache.

  5. Dans l'Éditeur du gestionnaire de connexions du cache, sous l'onglet Général, configurez le gestionnaire de connexions du cache en définissant les options suivantes :

    • Sélectionnez Utiliser le cache de fichier.

    • Pour Nom de fichier, tapez le chemin d'accès du fichier ou cliquez sur Parcourir pour sélectionner le fichier.

    Notes

    Le niveau de protection du package ne s'applique pas au fichier cache. Si le fichier cache contient des informations sensibles, utilisez une liste de contrôle d'accès (ACL) pour restreindre l'accès à l'emplacement ou au dossier dans lequel vous stockez le fichier. Vous devez autoriser l'accès à certains comptes uniquement. Pour plus d'informations, consultez Contrôle de l'accès aux fichiers utilisés par des packages.

  6. Cliquez sur l'onglet Colonnes, puis spécifiez quelles colonnes sont les colonnes d'index à l'aide de l'option Position d'index.

    Pour les colonnes qui ne sont pas des index, la position d'index est 0. Pour les colonnes d'index, la position d'index est un nombre séquentiel, positif.

    Notes

    Lorsque la transformation de recherche est configurée pour utiliser un gestionnaire de connexions du cache, seules les colonnes d'index dans le dataset de référence peuvent être mappées avec des colonnes d'entrée. En outre, toutes les colonnes d'index doivent être mappées. Pour plus d'informations, consultez Éditeur du gestionnaire de connexions du cache.

  7. Sous l'onglet Flux de contrôle, ajoutez une tâche de flux de données au package, puis ajoutez une transformation de recherche au flux de données.

  8. Configurez la transformation de recherche en procédant comme suit :

    1. Connectez la transformation de recherche au flux de données en faisant glisser un connecteur (la flèche verte ou rouge) à partir d'une source ou d'une transformation précédente jusqu'à la transformation de recherche.

      Notes

      Une transformation de recherche peut ne pas se valider si cette transformation se connecte à un fichier plat qui contient un champ Date vide. La validation de la transformation dépend si le gestionnaire de connexions pour le fichier plat a été configuré pour conserver des valeurs NULL. Pour garantir la validation de la transformation de recherche, dans l'Éditeur de source de fichier plat, dans la page Gestionnaire de connexions, sélectionnez l'option Conserver les valeurs NULL de la source comme valeurs NULL dans le flux de données.

    2. Double-cliquez sur la transformation source ou précédente pour configurer le composant.

    3. Double-cliquez sur la transformation de recherche, puis dans l'Éditeur de transformation de recherche, sur la page Général, sélectionnez Cache complet.

    4. Sélectionnez Gestionnaire de connexions du cache dans la zone Type de connexion.

    5. Sélectionnez une option de gestion des erreurs pour les lignes sans entrées correspondantes dans la liste Spécifier comment gérer les lignes sans entrées correspondantes.

    6. Sur la page Connexion, dans la liste Gestionnaire de connexions du cache, sélectionnez le gestionnaire de connexions du cache que vous avez ajouté.

    7. Cliquez sur la page Colonnes, puis faites glisser au moins une colonne de la liste Colonnes d'entrée disponibles vers une colonne de la liste Colonnes de recherche disponibles.

      Notes

      La transformation de recherche mappe automatiquement les colonnes ayant le même nom et le même type de données.

      Notes

      Les types de données des colonnes doivent correspondre pour que les colonnes puissent être mappées. Pour plus d'informations, consultez Types de données d'Integration Services.

    8. Dans la liste Colonnes de recherche disponibles, sélectionnez des colonnes. Ensuite, dans la liste Opération de recherche, spécifiez si les valeurs des colonnes de recherche remplacent les valeurs des colonnes d'entrée ou sont écrites dans une nouvelle colonne.

    9. Pour configurer la sortie d'erreur, cliquez sur la page Sortie d'erreur et définissez les options de gestion des erreurs. Pour plus d'informations, consultez Éditeur de transformation de recherche (page Sortie d'erreur).

    10. Cliquez sur OK pour enregistrer vos modifications apportées à la transformation de recherche.

  9. Exécutez le package.