Comment mettre à jour l’index avec GroupDocs.Search & Redaction (.NET)

Dans les entreprises modernes axées sur les données, how to update index rapidement et de manière fiable peut faire ou défaire votre expérience de recherche. Que vous gériez des milliers de contrats ou une vaste base de connaissances, maintenir l’index de recherche synchronisé avec les dernières modifications de documents est essentiel pour des résultats rapides et précis. Ce tutoriel vous guide à travers l’utilisation de GroupDocs.Search pour .NET conjointement avec GroupDocs.Redaction pour update index les fichiers, gérer les index versionnés et protéger le contenu sensible — le tout dans un projet .NET propre.

Réponses rapides

  • What does “how to update index” mean? C’est le processus de modification d’un index de recherche existant afin que les nouveaux documents ou ceux modifiés deviennent recherchables sans reconstruction complète.
  • Which libraries are required? GroupDocs.Search et GroupDocs.Redaction pour .NET (disponibles tous deux via NuGet).
  • Do I need a license? Un essai gratuit suffit pour les tests ; une licence de production débloque toutes les fonctionnalités.
  • Can I run this on .NET Core? Oui, les bibliothèques prennent en charge .NET Framework 4.5+, .NET Core 3.1+ et .NET 5/6+.
  • What performance can I expect? Mettre à jour un index de 1 Go avec 2 threads se termine en moins d’une minute sur un serveur typique à 4 cœurs.

Qu’est‑ce que “how to update index” ?

How to update index désigne la technique d’appliquer des modifications incrémentielles à un index de recherche existant plutôt que de le recréer entièrement. Cette approche réduit les temps d’arrêt, économise des cycles CPU et maintient vos résultats de recherche à jour lorsque des documents sont ajoutés, modifiés ou supprimés.

Pourquoi utiliser GroupDocs.Search & Redaction pour les mises à jour d’index ?

GroupDocs.Search prend en charge plus de 50 formats de fichiers (PDF, DOCX, XLSX, PPTX, HTML, images, etc.) et peut traiter des documents de plusieurs centaines de pages sans charger le fichier complet en mémoire. Associé à GroupDocs.Redaction, vous pouvez automatiquement supprimer ou masquer les données sensibles avant l’indexation, garantissant la conformité tout en maintenant la pertinence de la recherche.

Prérequis

  • GroupDocs.Search – installer via NuGet.
  • GroupDocs.Redaction for .NET – requis pour les capacités de rédaction.
  • Visual Studio (ou tout IDE .NET) avec .NET 6+ installé.
  • Connaissances de base en C# et familiarité avec les concepts d’indexation.

Bibliothèques requises et versions

  • GroupDocs.Search – dernière version stable disponible sur NuGet.
  • GroupDocs.Redaction for .NET – dernière version stable disponible sur NuGet.

Exigences de configuration de l’environnement

  • Une machine Windows ou Linux avec le SDK .NET installé.
  • Accès à un dossier où les fichiers d’index seront stockés.

Prérequis de connaissances

  • Compréhension des fondamentaux de l’indexation de documents et de la recherche.
  • Connaissance de la gestion du cycle de vie des documents dans les systèmes d’entreprise.

Configuration de GroupDocs.Redaction pour .NET

Installer les packages

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

NuGet Package Manager UI

  • Recherchez “GroupDocs.Redaction” et installez la dernière version.

Étapes d’obtention de licence

  1. Free Trial – commencez avec un essai pour explorer toutes les fonctionnalités.
  2. Temporary License – demandez une clé temporaire pour des tests prolongés.
  3. Purchase – obtenez une licence complète pour les déploiements en production.

Initialisation et configuration de base

Redactor est la classe principale qui applique les règles de rédaction aux documents.
Pour commencer, référencez l’espace de noms Redaction et créez une instance de Redactor :

using GroupDocs.Redaction;

Guide de mise en œuvre

Nous couvrirons deux capacités principales : la mise à jour des documents indexés et la gestion du contrôle de version de l’index.

Comment mettre à jour l’index avec GroupDocs.Search ?

Index représente la collection recherchable stockée sur disque.
UpdateOptions configure la façon dont les mises à jour incrémentielles sont effectuées (par ex., le nombre de threads).
UpdateDocument applique les modifications à un seul document, et Commit finalise toutes les mises à jour en attente.

Réponse directe (40‑70 mots) :
Créez un objet Index pointant vers votre dossier d’index, utilisez UpdateOptions pour spécifier le nombre de threads, appelez UpdateDocument pour chaque fichier modifié, puis invoquez Commit pour persister les changements. Cette approche incrémentielle ne met à jour que les parties modifiées, maintenant l’index à jour sans reconstruction complète.

Fonctionnalité 1 : Mettre à jour les documents indexés

Vue d’ensemble

Mettre à jour les documents indexés garantit que vos résultats de recherche reflètent le contenu le plus récent, même lorsque les documents sont modifiés ou remplacés.

Étape 1 : Créer un index

La classe Index est l’objet de niveau supérieur qui représente une collection recherchable sur disque.

string indexFolder = @"YOUR_DOCUMENT_DIRECTORY/UpdateIndexedDocuments/Index";
Index index = new Index(indexFolder);
Étape 2 : Ajouter des documents à l’index

Ajoutez des fichiers depuis un répertoire ; la bibliothèque extrait automatiquement le texte recherchable.

string documentFolder = @"YOUR_DOCUMENT_DIRECTORY/Documents";
index.Add(documentFolder);
Étape 3 : Rechercher et mettre à jour

Exécutez une requête, modifiez le fichier source, puis appelez UpdateDocument avec les mêmes UpdateOptions utilisées lors de l’indexation.

string query = "son";
SearchResult searchResult = index.Search(query);

UpdateOptions options = new UpdateOptions { Threads = 2 };
index.Update(options);

SearchResult searchResult2 = index.Search(query);

Pourquoi cela fonctionne : En définissant Threads = 2, la mise à jour exploite deux cœurs CPU, réduisant le temps de traitement d’environ moitié sur une machine quad‑core.

Comment maintenir le contrôle de version de l’index ?

IndexUpdater est une classe utilitaire qui met à niveau les anciens formats d’index vers la dernière version prise en charge par la bibliothèque.

Réponse directe (40‑70 mots) :
Instanciez IndexUpdater avec le chemin de votre index existant, appelez CanUpdateVersion() pour vérifier la compatibilité, puis exécutez UpdateVersion() si nécessaire. Après la mise à jour, rechargez l’index avec le nouveau format et effectuez une recherche pour confirmer que tout fonctionne. Cela assure une migration fluide entre les versions de la bibliothèque.

Fonctionnalité 2 : Maintenir le contrôle de version de l’index

Vue d’ensemble

Le contrôle de version garantit que les anciens index restent recherchables après une mise à jour de la bibliothèque.

Étape 1 : Vérifier la compatibilité

IndexUpdater vérifie si l’index actuel peut être mis à niveau vers le dernier format.

string oldIndexFolder = @"YOUR_DOCUMENT_DIRECTORY/OldIndex";
string sourceIndexFolder = @"YOUR_DOCUMENT_DIRECTORY/UpdateIndexVersion/IndexS";
string targetIndexFolder = @"YOUR_DOCUMENT_DIRECTORY/UpdateIndexVersion/IndexT";

IndexUpdater updater = new IndexUpdater();
if (updater.CanUpdateVersion(sourceIndexFolder))
{
    VersionUpdateResult result = updater.UpdateVersion(sourceIndexFolder, targetIndexFolder);
}
Étape 2 : Charger et rechercher

Après la mise à jour, chargez l’index rafraîchi et exécutez une requête pour vérifier l’intégrité.

Index index = new Index(targetIndexFolder);
string query = "eagerness";
SearchResult searchResult = index.Search(query);

Pourquoi cela fonctionne : La garde CanUpdateVersion empêche les exceptions d’exécution causées par des schémas d’index incompatibles, offrant un chemin de mise à jour sécurisé.

Applications pratiques

Scénarios réels où how to update index est important :

  1. Legal Document Management – Réindexez rapidement les contrats après des amendements tout en masquant les clauses confidentielles.
  2. Corporate Archives – Gardez les archives historiques recherchables sans retraiter des millions de fichiers.
  3. Content Management Systems (CMS) – Appliquez des mises à jour incrémentielles à l’index de recherche lorsque les auteurs publient de nouveaux articles.

Considérations de performance

  • Threading Options : Ajustez UpdateOptions.Threads en fonction des cœurs CPU ; plus de threads améliorent le débit mais augmentent l’utilisation de la mémoire.
  • Resource Usage : Surveillez la RAM ; la bibliothèque diffuse les fichiers, ainsi les pics de mémoire restent minimes même pour des PDF de 500 pages.
  • Best Practices : Planifiez des mises à jour incrémentielles régulières et nettoyez les versions d’index obsolètes pour maintenir des performances optimales.

Problèmes courants et solutions

ProblèmeCauseSolution
Index not foundChemin du dossier incorrectVérifiez que le constructeur Index pointe vers le répertoire correct.
Version mismatch errorUtilisation d’un index ancien avec une bibliothèque plus récenteExécutez le flux IndexUpdater avant l’indexation normale.
Redaction not appliedRègles de rédaction chargées après l’indexationAppliquez la rédaction avant d’ajouter des documents à l’index.

Questions fréquentes

Q : Quelle est la différence entre UpdateDocument et Rebuild ?
A : UpdateDocument ne modifie que les fichiers modifiés, tandis que Rebuild recrée l’intégralité de l’index à partir de zéro, consommant plus de temps et de ressources.

Q : Puis-je mettre à jour plusieurs documents en parallèle ?
A : Oui, définissez UpdateOptions.Threads au nombre de cœurs que vous souhaitez utiliser ; la bibliothèque gère le traitement parallèle en interne.

Q : GroupDocs.Search prend‑il en charge les PDF chiffrés ?
A : Absolument. Fournissez le mot de passe via SearchOptions.Password lors du chargement du document.

Q : Comment vérifier que la rédaction a réussi avant l’indexation ?
A : Appelez Redactor.Apply() et inspectez la taille du fichier de sortie ; une taille réduite indique souvent une rédaction réussie.

Q : Quelles versions de .NET sont officiellement prises en charge ?
A : .NET Framework 4.5+, .NET Core 3.1+, .NET 5 et .NET 6+.

Conclusion

Vous disposez maintenant d’un guide complet et prêt pour la production sur how to update index utilisant GroupDocs.Search et sur la façon de garder ces index compatibles avec les versions de GroupDocs.Redaction pour .NET. En suivant les étapes ci‑dessus, vous pouvez garantir que votre couche de recherche reste rapide, précise et conforme aux réglementations de confidentialité des données.

Prochaines étapes :

  • Expérimentez différents paramètres Threads pour trouver le réglage optimal pour votre matériel.
  • Explorez des modèles de rédaction avancés (par ex., suppression de SSN basée sur des expressions régulières) avant l’indexation.
  • Intégrez la routine de mise à jour de l’index dans votre pipeline CI/CD pour une gestion de documents entièrement automatisée.

Dernière mise à jour : 2026-06-07
Testé avec : GroupDocs.Search 23.10 for .NET, GroupDocs.Redaction 23.10 for .NET
Auteur : GroupDocs

Ressources

Tutoriels associés