Configurer la recherche distribuée avec le réseau GroupDocs.Search Java

Dans le monde actuel axé sur les données, configurer la recherche distribuée est essentiel pour gérer d’énormes collections de documents tout en maintenant des temps de réponse faibles. Ce tutoriel vous guide dans la mise en place d’un réseau robuste GroupDocs.Search pour Java, montrant comment déployer la recherche sur plusieurs nœuds, ajouter des documents à l’index, et configurer les paramètres TCP pour une communication fiable. À la fin, vous disposerez d’une solution de recherche évolutive prête pour la production et d’une compréhension claire des raisons pour lesquelles cette architecture surpasse une configuration mononœud.

Réponses rapides

  • Qu’est-ce que la configuration de la recherche distribuée ? C’est le processus de liaison de plusieurs nœuds de recherche indépendants afin qu’ils indexent et répondent aux requêtes collectivement, offrant un débit plus élevé et une tolérance aux pannes.
  • Combien de nœuds sont recommandés ? En général, 3 à 5 nœuds offrent un bon équilibre entre performance et tolérance aux pannes pour la plupart des charges de travail d’entreprise.
  • Ai-je besoin d’une licence ? Oui – une licence temporaire ou complète est requise pour l’utilisation en production de GroupDocs.Search.
  • Quels ports dois-je utiliser ? Choisissez des ports libres sur vos serveurs ; l’exemple utilise 49136‑49139, mais toute plage ouverte fonctionne.
  • Puis-je ajouter de nouveaux documents après le déploiement ? Absolument – vous pouvez ajouter des documents à l’index à tout moment sans redémarrer le réseau.

Qu’est-ce que la configuration de la recherche distribuée ?

Configurer une architecture de recherche distribuée signifie lier plusieurs nœuds de recherche indépendants afin qu’ils partagent le travail d’indexation et répondent aux requêtes collectivement. Cela réduit la charge sur chaque machine, améliore à la fois le débit et la fiabilité, et fournit une redondance intégrée pour la tolérance aux pannes.

Pourquoi utiliser GroupDocs.Search pour Java ?

GroupDocs.Search pour Java offre une indexation haute performance (jusqu’à 1 Go/s sur du matériel moderne) et une architecture évolutive qui prend en charge des clusters de plus de 10 nœuds. Il comprend nativement plus de 50 formats de documents — y compris PDF, DOCX, XLSX, PPTX et les fichiers e‑mail—vous permettant d’indexer pratiquement tout contenu métier sans convertisseurs supplémentaires. La classe intégrée TcpSettings vous permet d’ajuster finement la latence, le débit et les intervalles de keep‑alive, assurant une communication inter‑nœuds fiable même à travers les limites de centres de données. TcpSettings configure les paramètres de communication TCP de bas niveau entre les nœuds.

Prérequis

Bibliothèques et dépendances requises

Vous aurez besoin de GroupDocs.Search pour Java version 25.4 ou ultérieure. Assurez‑vous que votre environnement de développement possède Java installé.

Exigences de configuration de l’environnement

  • Un Java Development Kit (JDK) 11 ou plus récent.
  • Un IDE tel qu’IntelliJ IDEA ou Eclipse pour une gestion de projet pratique.

Prérequis de connaissances

Des compétences de base en programmation Java et une compréhension générale de la configuration réseau vous aideront à suivre les étapes sans problème.

Configuration de GroupDocs.Search pour Java

Pour commencer, ajoutez GroupDocs.Search pour Java à votre projet. Vous pouvez le faire via Maven ou en téléchargeant directement la bibliothèque.

Maven Setup
Ajoutez le dépôt et la configuration de dépendance suivants dans votre fichier pom.xml :

<repositories>
    <repository>
        <id>repository.groupdocs.com</id>
        <name>GroupDocs Repository</name>
        <url>https://releases.groupdocs.com/search/java/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-search</artifactId>
        <version>25.4</version>
    </dependency>
</dependencies>

Téléchargement direct
Vous pouvez également télécharger la dernière version depuis GroupDocs.Search for Java releases.

Acquisition de licence

Pour exploiter pleinement GroupDocs.Search, vous pouvez obtenir une licence temporaire ou en acheter une. Consultez la page de licence de GroupDocs pour plus d’informations sur la façon d’obtenir un essai gratuit ou une licence complète. Vous pouvez également utiliser la page de licence de GroupDocs à la même fin.

Initialisation et configuration de base

Initialisons GroupDocs.Search dans votre application Java :

import com.groupdocs.search.*;

public class SearchSetup {
    public static void main(String[] args) {
        // Create an index in the specified folder
        Index index = new Index("YOUR_INDEX_DIRECTORY");

        // Add documents to the index
        index.add("YOUR_DOCUMENT_DIRECTORY");
    }
}

Guide d’implémentation

Dans cette section, nous vous guiderons à travers la configuration et le déploiement d’un réseau de recherche en utilisant GroupDocs.Search pour Java.

Comment configurer la recherche distribuée avec GroupDocs.Search ?

Chargez la configuration du réseau, définissez les chemins de base et réglez les paramètres TCP en quelques lignes de code. Ce modèle de réponse directe vous montre les étapes essentielles avant toute explication détaillée.

Tout d’abord, créez un objet SearchNetworkConfig, spécifiez un répertoire de base partagé et attribuez un port TCP distinct à chaque nœud. SearchNetworkConfig définit les paramètres du cluster de recherche distribuée, tels que le répertoire de base et les ports des nœuds. Ensuite, instanciez TcpSettings — la classe qui contrôle le délai d’attente des sockets, la taille du tampon et le comportement keep‑alive. Enfin, appelez NetworkManager.deploy(config) pour lancer le cluster. NetworkManager gère le déploiement et la gestion des nœuds de recherche au sein du cluster.

Configuration du réseau

La classe TcpSettings est le centre de configuration pour toute communication TCP entre les nœuds. Elle vous permet de définir le délai d’attente de connexion, les tailles des tampons de lecture/écriture, et d’activer ou non l’algorithme de Nagle.

Configuration configuration = ConfiguringSearchNetwork.configure("YOUR_DOCUMENT_DIRECTORY", 49136);

Déploiement des nœuds

Déployez chaque nœud en fournissant son identifiant unique et la configuration définie précédemment. La routine de déploiement enregistre automatiquement le nœud auprès du cluster, ouvre le socket d’écoute et lance les threads d’indexation en arrière‑plan.

public static SearchNetworkNode[] deploy(String basePath, int basePort, Configuration configuration) {
    // Define timeouts for sending and receiving data over the network.
    int sendTimeout = 3000;
    int receiveTimeout = 3000;

    // Create and start three nodes that can run on separate servers or together.
    SearchNetworkNode node1 = new SearchNetworkNode(
        1,
        basePath + "Node1",
        new TcpSettings(basePort + 1, sendTimeout, receiveTimeout)
    );
    node1.start();

    SearchNetworkNode node2 = new SearchNetworkNode(
        2,
        basePath + "Node2",
        new TcpSettings(basePort + 2, sendTimeout, receiveTimeout)
    );
    node2.start();

    SearchNetworkNode node3 = new SearchNetworkNode(
        3,
        basePath + "Node3",
        new TcpSettings(basePort + 3, sendTimeout, receiveTimeout)
    );
    node3.start();

    // Create and configure the main configuration node.
    SearchNetworkNode node0 = new SearchNetworkNode(
        0,
        basePath + "Node0",
        new TcpSettings(basePort, sendTimeout, receiveTimeout),
        new ConsoleLogger(),
        configuration
    );

    // Add an event handler to notify when the configuration is complete.
    node0.getEvents().ConfigurationCompleted.add(new EventHandler() {
        @Override
        public void invoke(Object s, EventArgs e) {
            // Event handling logic here (e.g., logging)
        }
    });

    // Configure all nodes in the network using the main configuration node.
    node0.configureAllNodes();

    // Start the search network by launching all configured nodes.
    node0.start();

    // Return an array of all deployed nodes.
    return new SearchNetworkNode[] {node0, node1, node2, node3};
}

Problèmes courants et solutions

  • Erreurs d’accès au répertoire – Assurez‑vous que le répertoire de base de chaque nœud existe et que le processus Java dispose des permissions de lecture/écriture.
  • Conflits de ports – Vérifiez que les ports choisis (par ex., 49136‑49139) ne sont pas utilisés par d’autres services ; vous pouvez exécuter netstat -an pour vérifier.
  • Délais d’attente sur réseaux lents – Augmentez TcpSettings.setConnectionTimeout() si vous rencontrez des déconnexions fréquentes dans des environnements à haute latence.
  • Corruption d’index – Sauvegardez régulièrement le dossier d’index et activez NetworkManager.enableAutoRecovery() pour reconstruire automatiquement les fragments corrompus.

Applications pratiques

Déployer un réseau de recherche distribuée peut être bénéfique dans divers scénarios :

  1. Systèmes d’entreprise à grande échelle – Indexez des millions de contrats, politiques et rapports tout en maintenant des réponses aux requêtes en sous‑seconde.
  2. Plateformes de gestion de contenu – Servez des milliers d’utilisateurs simultanés recherchant parmi des actifs multimédias sans goulets d’étranglement.
  3. Sites e‑commerce – Accélérez les recherches de produits et la navigation à facettes sur des catalogues contenant des millions de SKU.

Considérations de performance

Pour que votre configurer la recherche distribuée fonctionne efficacement :

  • Gestion de la taille de l’index – GroupDocs.Search peut gérer des index dépassant 100 Go ; toutefois, surveillez les I/O disque et envisagez de fragmenter les grandes collections sur plusieurs nœuds.
  • Ajustement des ressources – Appliquez les options de réglage de mémoire Java (-Xmx8g -Xms4g) selon votre charge de travail, et ajustez TcpSettings.setReadBufferSize() pour les réseaux à haut débit.
  • Surveillance de la santé – Utilisez le NetworkHealthMonitor intégré pour suivre le CPU, la mémoire et la latence réseau par nœud, et définissez des alertes pour les seuils que vous choisissez.

Conclusion

En suivant ce tutoriel, vous avez appris à configurer la recherche distribuée et à déployer un réseau GroupDocs.Search Java évolutif. Cette solution peut améliorer de façon spectaculaire la vitesse et la fiabilité des fonctions de recherche de votre application, surtout lorsqu’il s’agit de collections de documents volumineuses et hétérogènes.

Prochaines étapes

Explorez des capacités avancées telles que les analyseurs personnalisés, la gestion des synonymes et l’indexation en temps réel pour affiner davantage votre expérience de recherche. Vous pouvez également intégrer le réseau à une couche API RESTful afin d’exposer la fonctionnalité de recherche aux clients externes.

Appel à l’action

Commencez dès aujourd’hui à implémenter cette solution robuste dans vos projets et constatez vous‑même le gain de performance !

Questions fréquentes

Q : Qu’est‑ce que GroupDocs.Search pour Java ?
R : GroupDocs.Search pour Java est une bibliothèque haute performance qui indexe et recherche du texte dans plus de 50 formats de documents, offrant une recherche plein texte rapide et évolutive pour les applications Java.

Q : Comment obtenir une licence temporaire pour GroupDocs.Search ?
R : Consultez la page de licence de GroupDocs pour demander un essai gratuit ou acheter une licence complète pour une utilisation en production.

Q : Puis‑je ajouter de nouveaux documents après le déploiement du réseau ?
R : Oui, vous pouvez ajouter des documents à l’index à tout moment en utilisant la méthode IndexManager.addDocument() ; les modifications se propagent automatiquement à travers le cluster. IndexManager.addDocument() ajoute un nouveau document à l’index et le propage sur le réseau.

Q : Quels sont les pièges courants lors de la configuration des nœuds ?
R : Les problèmes typiques incluent des chemins de base incompatibles, des conflits de ports et des permissions de système de fichiers insuffisantes. Vérifiez soigneusement la configuration de chaque nœud et assurez‑vous que tous les répertoires sont accessibles.

Q : Le réseau prend‑il en charge l’indexation en temps réel ?
R : Absolument. GroupDocs.Search propose des API d’indexation en temps réel qui rendent immédiatement les documents nouvellement ajoutés recherchables sur tous les nœuds sans interruption.

Dernière mise à jour : 2026-06-27
Testé avec : GroupDocs.Search 25.4 pour Java
Auteur : GroupDocs

Tutoriels associés