Exemple ItemFinder

Mis à jour : 5 décembre 2005

L'exemple ItemFinder montre des techniques permettant d'implémenter des fonctionnalités de recherche dans des applications de base de données. Grâce à la base de données exemple AdventureWorks et aux fonctionnalités de recherche de texte intégral de Microsoft SQL Server 2005, ItemFinder permet aux utilisateurs d'effectuer des recherches dans des curriculum vitæ et des descriptions de produit stockés en langage xml, ainsi que dans des documents stockés sous forme d'objets BLOB (Binary Large Objects). Cet exemple d'application illustre les aspects suivants :

• Techniques avancées, telles que la pagination et la mise en cache.
• Nouvelles fonctionnalités de recherche de texte intégral, par exemple la prise en charge multilingue améliorée et l'implémentation de type de données xml.

Emplacement par défaut : C:\Program Files\Microsoft SQL Server\90\Samples\Engine\Full Text Search\ItemFinder

Langages

Transact-SQL

Fonctionnalités

Configuration requise

Avant d'exécuter cet exemple, vérifiez que le logiciel suivant est installé :

• SQL Server 2005
• Base de données AdventureWorks incluse dans SQL Server 2005 et également disponible sur la page Web du Microsoft SQL Server Developer Center (en anglais).

Génération de l'exemple

Si vous n'avez pas encore créé un fichier de clé de nom fort, utilisez la procédure suivante pour générer ce fichier.

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

1. Ouvrez une invite de commandes Microsoft Visual Studio 2005. Cliquez sur Démarrer, pointez sur Tous les programmes et sur Kit de développement Microsoft .NET Framework SDK 2.0, puis cliquez sur Invite de commandes du Kit de développement SDK.

   -- Ou --

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

2. Utilisez la commande CD (changer de répertoire) pour remplacer le dossier actif dans la fenêtre de l'invite de commandes par le dossier dans lequel les exemples sont installés.

   Remarque :

   Pour déterminer le dossier dans lequel se trouvent les exemples, cliquez sur le bouton 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\100\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.

Utilisez la procédure suivante pour générer l'exemple :

Étape 1 : Chargez et exécutez le script

1. Dans SQL Server Management Studio, chargez et exécutez le script Scripts\install.sql pour installer les index de texte intégral et créer les procédures stockées suivantes :

   • usp_SearchResumes
   • usp_SearchProducts
   • usp_SearchDocuments
   • usp_AddDocument

Étape 2 : Générez l'application

1. Générez l'application à l'aide de Microsoft Visual Studio 2005 ou tapez la commande suivante dans une fenêtre d'invite de commandes .NET Framework :

msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\ItemFinder.sln

Exécution de l'exemple

Pour exécuter l'exemple, vous devez mener à bien les étapes suivantes :

Étape 1 : Exécutez l'exemple

1. Exécutez bin\Release\ItemFinder.exe (ou bin\Debug\ItemFinder.exe).

Commentaires

L'exemple d'application ItemFinder fournit une interface utilisateur qui vous permet d'effectuer des recherches dans des curriculum vitæ, des descriptions de produit et des documents. Vous pouvez également utiliser cet exemple pour ajouter des documents à la table Document.

Les données de l'exemple sont disponibles en différents langages et formats. Un ensemble de listes déroulantes vous permet de sélectionner une bibliothèque (Curriculum vitæ, Produits ou Documents), un langage (tout langage pris en charge par la recherche de texte intégral), un nombre maximal de résultats et un type de recherche (CONTAINS ou FREETEXT).

Utilisez ItemFinder pour les tâches suivantes :

Choisir une condition de recherche

Entrez la condition de recherche dans la zone de texte et cliquez sur OK pour exécuter la requête.

Si vous choisissez le type de recherche CONTAINS, ItemFinder emploie la syntaxe contains_search_condition. Par exemple, vous pouvez rechercher « rear reflector » à l'aide de l'opérateur de proximité NEAR en tapant dans la zone de texte : "rear" NEAR "reflector". Quelle que soit la condition de recherche que vous utilisez, veillez à placer le texte que vous cherchez entre guillemets doubles ("texte cherché"). Pour plus d'informations, consultez CONTAINS (Transact-SQL).

De manière analogue, si vous choisissez le type de recherche FREETEXT, ItemFinder emploie la syntaxe freetext_search_condition. Par exemple, pour reprendre la condition de recherche "rear reflector" ci-dessus, tapez dans la zone de texte : rear reflector. À la différence de CONTAINS, toutefois, vous ne placez pas le texte cherché entre guillemets. Pour plus d'informations, consultez FREETEXT (Transact-SQL).

Parcourir de vastes résultats de recherche

Si les résultats de la recherche ne tiennent pas sur une seule page de l'élément ListView, seule la première page de résultats s'affiche. Un cache interne, simple et efficace, stocke les valeurs de clé et de rang qui correspondaient aux critères de recherche ainsi que toutes les données déjà extraites.

Pour faire défiler les pages de résultats, utilisez les boutons Dernier et Suivant.

Pour effacer le cache, cliquez sur Effacer les résultats, effectuez une nouvelle recherche ou fermez l'application.

Changer le nom d'hôte du serveur de base de données

Le nom d'hôte du serveur de base de données à utiliser est stocké dans le fichier app.config.

Pour changer le nom d'hôte :

1. Cliquez sur Modifier, puis cliquez sur Paramètres de base de données...
2. Modifiez le fichier app.config directement.

Ajouter des types de documents pris en charge à la table Document

Pour ajouter des types de documents, cliquez sur Fichier, puis sur Ajouter un nouveau fichier....

Par ailleurs, vous pouvez utiliser le menu Ajouter un nouveau fichier... pour les tâches suivantes :

• Spécifier un nom pour un fichier.
• Placer un fichier dans le système de fichiers.
• Spécifier le type de fichier.
• Stocker une brève description du fichier.

Obtenir de l'aide sur l'exemple

Pour obtenir des informations sur l'exemple, cliquez sur le menu ? (Aide) et sélectionnez À propos de.

Voir aussi

Autres ressources

Améliorations apportées à la recherche de texte intégral
CREATE FULLTEXT CATALOG (Transact-SQL)
ALTER FULLTEXT CATALOG (Transact-SQL)
DROP FULLTEXT CATALOG (Transact-SQL)
CREATE FULLTEXT INDEX (Transact-SQL)
ALTER FULLTEXT INDEX (Transact-SQL)
DROP FULLTEXT INDEX (Transact-SQL)
CONTAINS (Transact-SQL)
CONTAINSTABLE (Transact-SQL)
FREETEXT (Transact-SQL)
FREETEXTTABLE (Transact-SQL)

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications