スケーラブルな検索ネットワークの構築 – GroupDocs.Javaでドキュメントをインデックスに追加

このチュートリアルでは、GroupDocs.Search for Java を使用して インデックスにドキュメントを追加する方法 と スケーラブルな検索ネットワークを構築する方法 を学びます。検索ネットワークの設定、ノードのデプロイ、イベントの処理について説明し、アプリケーションが複数サーバーにまたがる大規模なドキュメントコレクションを効率的に処理できるようにします。

クイック回答

• 「インデックスにドキュメントを追加する」とは何ですか？ それは、検索可能なインデックスにファイルを挿入し、迅速にクエリできるようにすることを意味します。
• どのライブラリがこの機能を提供しますか？ GroupDocs.Search for Java。
• ライセンスは必要ですか？ 一時的なトライアルライセンスが利用可能です。商用利用には商用ライセンスが必要です。
• 水平スケーリングは可能ですか？ はい、複数の SearchNetworkNode インスタンスをデプロイすることで可能です。
• 必要な Java バージョンは何ですか？ JDK 8 以上。

インデックスにドキュメントを追加するとは

PDF、DOCX、PPTX などのソースファイルを GroupDocs.Search エンジンにロードします。エンジンはテキストを抽出し、用語頻度テーブルを構築し、インデックスファイルに保存します。生成されたインデックスにより、数百ページ規模のコレクションでもサブ秒レベルのキーワード検索が可能になります。

ネットワーク環境で GroupDocs.Search for Java を使用する理由

インデックス作成と検索のワークロードを複数ノードに分散させ、データソースに近い場所でクエリ遅延を削減し、ダウンタイムなしでノードの追加・削除が可能です。このアーキテクチャにより、複数サーバーにまたがって検索 でき、パフォーマンスを一定に保つことができます。

前提条件

• Java Development Kit (JDK) 8+ がインストールされていること。
• 依存関係管理のための Maven。
• Java と Maven プロジェクト構造の基本的な知識。

必要なライブラリ、バージョン、依存関係

GroupDocs.Search for Java を実装するには、Maven プロジェクトに以下を含めます。

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

あるいは、最新バージョンを GroupDocs.Search for Java releases からダウンロードしてください。リリースは GroupDocs Search Java releases でも確認できます。

環境設定要件

• システムに JDK 8 以上がインストールされていること。
• Maven がインストールされ、Maven プロジェクトを使用する場合は設定されていること。

知識の前提条件

• Java プログラミングの基本的な理解。
• Maven での依存関係管理に慣れていること。

GroupDocs.Search for Java の設定

1. Maven Setup: 上記のリポジトリと依存関係を pom.xml ファイルに追加します。
2. Direct Download: あるいは、GroupDocs Search Java releases からライブラリをダウンロードします。

ライセンス取得

• GroupDocs website で無料トライアルまたは一時ライセンスを取得してください。
• フルアクセスとサポートが必要な場合は、商用ライセンスの購入をご検討ください。

基本的な初期化

Java アプリケーションで GroupDocs.Search を初期化します。

import com.groupdocs.search.*;

public class SearchSetup {
    public static void main(String[] args) {
        // Initialize an index
        Index index = new Index("path/to/index/directory");

        // Add documents to the index
        index.add("path/to/documents");
        
        System.out.println("GroupDocs.Search setup complete.");
    }
}

検索ネットワークでインデックスにドキュメントを追加する方法

ネットワーク内の任意のノードを通じてドキュメントをロードすると、フレームワークが自動的にインデックス作成のワークロードを分散し、負荷をバランスさせ、共有インデックスをリアルタイムで更新します。各ノードは割り当てられたファイルを処理し、テキストを抽出し、増分変更を書き込むことで、追加されたコンテンツがほぼ即座にすべてのノードで検索可能になります。

機能 1: 検索ネットワークの構成

概要

検索ネットワークの構成は、検索タスクを効率的に管理・分散するノードを設定することを含みます。

手順 1: ベースパスとポートの定義

SearchNetworkNode クラスは、分散インデックスに参加する単一ノードを表します。

String basePath = "YOUR_DOCUMENT_DIRECTORY/AdvancedUsage/Scaling/SearchNetworkNodeEvents/";
int basePort = 49140; // Change if necessary due to busy port issues

手順 2: ネットワークの構成

NetworkConfiguration は、起動時にすべてのノードが読み取る共通設定（ベースパス、ポート、レプリケーション係数）を保持します。

import com.groupdocs.search.scaling.*;
import com.groupdocs.search.scaling.configuring.*;

Configuration configuration = ConfiguringSearchNetwork.configure(basePath, basePort);

機能 2: 検索ネットワークノードのデプロイ

概要

ノードをデプロイして、ネットワーク全体で検索操作を分散・処理します。

手順 1: 設定を使用してノードをデプロイ

SearchNetworkNode インスタンスは同一の設定ファイルで起動され、定義されたベースポート範囲を介して相互に検出できます。

import com.groupdocs.search.scaling.*;

SearchNetworkNode[] nodes = SearchNetworkDeployment.deploy(basePath, basePort, configuration);

機能 3: ノードイベントの購読

概要

ノードイベントを購読することで、検索ネットワーク内のさまざまなアクションを監視し、対応できます。

手順 1: 購読メソッドの定義

NodeEventListener は、インデックス作成の進捗、エラー、ノードのヘルス変化に対するコールバックを受け取るために実装するインターフェイスです。

import com.groupdocs.search.events.*;
import com.groupdocs.search.scaling.events.*;

public static void subscribe(SearchNetworkNode node) {
    // Subscribe to IndexingCompleted event
    node.getEvents().IndexingCompleted.add(new EventHandler() {
        @Override
        public void invoke(Object s, EventArgs e) {
            System.out.println("Indexing completed.");
        }
    });

    // Additional events can be subscribed similarly...
}

手順 2: 購読メソッドの使用

各ノードにリスナーを登録し、大規模バッチ操作中にリアルタイムのフィードバックを取得できるようにします。

SearchNetworkNode masterNode = nodes[0];
subscribe(masterNode);

ノードの終了

ノードは常に正常にシャットダウンし、保留中の書き込みをフラッシュし、ネットワークソケットを解放してください。

for (SearchNetworkNode node : nodes) {
    node.close();
}

実用的な応用例

1. Enterprise Search Solutions – 複数サーバーにまたがる大規模ドキュメント検索を処理する検索ネットワークを実装します。
2. E‑commerce Platforms – 複数ノードにインデックス作成タスクを分散させ、製品検索機能を強化します。
3. Content Management Systems (CMS) – CMS 環境でのコンテンツ取得と更新のパフォーマンスを向上させます。

パフォーマンスに関する考慮事項

• システムのリソースに基づいてノードのデプロイを最適化します。
• 大規模データセットを扱う際は、特にメモリリークを防ぐために定期的にメモリ使用量を監視します。
• 設定を活用してインデックス作成と検索操作を微調整し、効率を向上させます。

よくある問題と解決策

よくある質問

Q: ノードをデプロイする際のポート競合はどう対処すればよいですか？
A: 設定コード内の basePort 変数を利用可能なポートに変更してください。

Q: GroupDocs.Search はリアルタイムインデックス作成に使用できますか？
A: はい、適切な設定を行うことでリアルタイムインデックス作成をサポートします。

Q: ノードデプロイ時に頻出する問題は何ですか？
A: ネットワーク接続とパス設定の誤りが頻繁に発生します。すべてのパスとポートが正しく設定されていることを確認してください。

Q: ネットワーク稼働中にインデックスにドキュメントを追加できますか？
A: もちろん可能です。任意のノードで index.add(...) を呼び出せば、ネットワークが自動的に新しいワークロードを分散します。

Q: 開発テストにライセンスは必要ですか？
A: テストには一時的なトライアルライセンスで十分です。商用利用には商用ライセンスが必要です。

リソース

• ドキュメント: GroupDocs Search Java ドキュメント
• API リファレンス: GroupDocs API リファレンス
• ダウンロード: 最新リリース
• GitHub: GroupDocs.Search GitHub リポジトリ
• 無料サポート: GroupDocs フォーラム
• 一時ライセンス取得: Obtain a Temporary License

このガイドに従うことで、インデックスにドキュメントを追加し、GroupDocs.Search for Java を使用して堅牢かつ スケーラブルな検索ネットワークを構築 できます。コーディングをお楽しみください！

最終更新日: 2026-05-22
テスト環境: GroupDocs.Search 25.4 for Java
作者: GroupDocs

関連チュートリアル

• Search Network Tutorials for GroupDocs.Search .NET
• How to Configure a .NET Search Network Using GroupDocs.Search and Redaction
• Deploy a Search Network Node in .NET using GroupDocs for Efficient Document Indexing and Retrieval