GroupDocs を使用した Java のメタデータ検索の方法

ドキュメントをインデックスに迅速かつ確実に追加することは、現代の検索駆動型アプリケーションの基盤です。法務リポジトリ、顧客サポートナレッジベース、内部ドキュメントポータルの構築に関わらず、metadata search with GroupDocs を使用すれば、全文検索を行わずに著者、タイトル、カスタムタグなどでファイルを特定できます。このチュートリアルでは、インデックス設定の構成、メタデータ中心のインデックス作成、ファイルの追加、正確な検索の実行方法を、GroupDocs.Search for Java を使って学びます。

簡単な回答

  • メタデータインデックスの主な目的は何ですか? 全文検索ではなく、ドキュメントのプロパティに基づく高速検索を可能にします。
  • インデックスにファイルを追加するメソッドはどれですか? index.add(YOUR_DOCUMENTS_FOLDER);
  • カスタムメタデータフィールドで検索できますか? はい、フィールドがインデックス化されれば直接クエリできます。
  • 開発にライセンスは必要ですか? 評価には一時的なトライアルライセンスで十分です。製品環境ではフルライセンスが必要です。
  • 必要な Java バージョンは何ですか? JDK 8 以上が推奨されます。

GroupDocs.Search におけるメタデータインデックスとは何ですか?

メタデータインデックスは、ドキュメント属性(例: 著者、作成日、カスタムタグ)を抽出し、検索可能な構造に保存します。add documents to index を実行すると、エンジンはこれらの属性を記録し、John Doe が著者の PDF をすべて検索する、または「author」で PDF を検索するといった正確なクエリを実行できるようになります。

メタデータインデックスに GroupDocs.Search を使用する理由は?

GroupDocs のメタデータ検索は、インデックスに数百万件のレコードが含まれていても軽量でサブ秒の応答時間を提供します。over 30 input and output formats をサポートし、PDF、DOCX、PPTX、HTML、画像ファイルなどを含み、典型的なサーバー上で 100 000 件のドキュメントインデックスに対して 200 MB 未満のヒープメモリで動作します。

前提条件

  • GroupDocs.Search for Java ≥ 25.4。
  • JDK 8 以上がインストールされ、設定済み。
  • Java と Maven の基本的な知識。

GroupDocs.Search for Java の設定

インストール手順

pom.xml に GroupDocs リポジトリと依存関係を追加します:

<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 からダウンロードできます。

ライセンス取得

テスト用の一時ライセンスを取得するには:

  1. GroupDocs のウェブサイトにアクセスし、Purchase セクションへ移動します。
  2. 評価ニーズに合った temporary license プランを選択します。

メタデータのインデックス設定を構成する方法は?

インデックス設定を構成すると、エンジンが抽出・保存する情報を指定できます。インデックスタイプを MetadataIndex に設定することで、GroupDocs.Search は全文ではなくメタデータフィールドに焦点を当て、インデックスサイズを削減しクエリを高速化します。この構成は IndexSettings オブジェクトを通じて適用され、カスタムメタデータフィールドも指定できます。

IndexSettings settings = new IndexSettings();
settings.setIndexType(IndexType.MetadataIndex);

機能 1: インデックス設定の構成

setIndexType(IndexType.MetadataIndex) 呼び出しは、エンジンに全文ではなくメタデータに焦点を当てるよう指示します。IndexType.MetadataIndex は、メタデータのみのインデックスモードを選択する列挙値です。

import com.groupdocs.search.IndexSettings;
import com.groupdocs.search.IndexType;

// Initialize index settings
IndexSettings settings = new IndexSettings();
settings.setIndexType(IndexType.MetadataIndex);  // Focus on metadata indexing

機能 2: 指定フォルダーにインデックスを作成する

すべてのメタデータが保存される物理的なインデックスディレクトリを作成します:

import com.groupdocs.search.Index;

String YOUR_INDEX_DIRECTORY = "YOUR_DOCUMENT_DIRECTORY\\\\output\\\\AdvancedUsage\\\\Indexing\\\\IndexingMetadataOfDocuments";

// Create index in specified directory using settings
Index index = new Index(YOUR_INDEX_DIRECTORY, settings);

YOUR_DOCUMENT_DIRECTORY をプロジェクト構成に合わせたパスに置き換えてください。

機能 3: ドキュメントをインデックスに追加する方法

index.add メソッドはフォルダー内のファイルをインデックスに追加し、メタデータを抽出します。index.add は各ドキュメントをスキャンし、サポートされているメタデータフィールドを読み取り、迅速な取得のためにインデックスに保存します。

String YOUR_DOCUMENTS_FOLDER = "YOUR_DOCUMENT_DIRECTORY";

// Add all documents in directory to the index
index.add(YOUR_DOCUMENTS_FOLDER);

ヒント:

  • フォルダーパスが正しく、アプリケーションに読み取り権限があることを確認してください。
  • GroupDocs.Search は各ファイルからサポートされているメタデータを自動的に抽出します。

機能 4: メタデータでドキュメントを検索する

メタデータフィールドを対象としたクエリを実行します。例えば、言語が英語のドキュメントを検索する場合:

import com.groupdocs.search.results.SearchResult;

String query = "English";  // Define search query
SearchResult result = index.search(query);  // Perform the search

// Process results (example)
for (int i = 0; i < result.getDocumentCount(); i++) {
    System.out.println("Found document: " + result.getFoundDocument(i).getFilePath());
}

search(query) メソッドはインデックス化されたメタデータを検索し、一致するドキュメントを返します。search pdf by author も、著者名をクエリ文字列として使用すれば実行できます。

実用的な応用例

  1. エンタープライズ文書管理: 契約日や署名者名で契約書を取得する。
  2. デジタルライブラリカタログ: ユーザーがジャンル、出版年、著者で本を閲覧できるようにする。
  3. CRM システム: 顧客 ID や地域などのカスタムメタデータを使用してクライアントファイルを迅速に検索する。

ヒントとベストプラクティス

  • インクリメンタル更新: インデックス全体を再構築する代わりに、新規または変更されたファイルには index.addOrUpdate() を使用する。
  • バッチ処理: 数千ファイルを扱う場合、メモリ使用量を抑えるために小さなバッチで追加する。
  • メタデータの検証: ソースドキュメントが実際にクエリ対象のメタデータ(例: PDF の著者フィールド)を含んでいることを確認する。

パフォーマンス上の考慮点

  • メモリ調整: インデックス化されたメタデータの量に応じて JVM ヒープサイズ(-Xmx)を調整する。
  • 最適化されたストレージ: 定期的に index.optimize() を呼び出してインデックスを圧縮し、クエリ速度を向上させる。

一般的な問題と解決策

問題解決策
結果が返されない期待するメタデータフィールドが実際にソースファイルに存在することを確認してください。
権限エラーJava プロセスがドキュメントフォルダーとインデックスディレクトリの両方に読み取りアクセス権を持っていることを確認してください。
メモリ不足エラーJVM ヒープサイズを増やすか、add 操作をバッチ化して小さなグループでファイルを処理してください。

よくある質問

Q: メタデータインデックスとは何ですか?
A: メタデータインデックスは、ドキュメント属性(著者、タイトル、カスタムタグ)を検索可能な構造に保存し、全文をスキャンせずに高速に検索できるようにします。

Q: 一時ライセンスはどう取得しますか?
A: GroupDocs の購入ページにアクセスし、手順に従ってトライアルライセンスを取得してください。

Q: この設定で PDF をインデックスできますか?
A: はい、GroupDocs.Search は PDF、DOCX、PPT など多くのフォーマットをサポートしています。

Q: ドキュメント追加時の一般的な問題は何ですか?
A: 正しいファイルパスを確認し、ディレクトリへの読み取り権限がアプリケーションにあることを確認してください。

Q: 検索パフォーマンスを最適化するには?
A: 定期的にインデックスを更新し、インクリメンタル追加を使用し、JVM メモリ設定を調整してください。

リソース


最終更新日: 2026-10-22
テスト対象: GroupDocs.Search Java 25.4
作者: GroupDocs

関連チュートリアル