23.2.9. インデックス形式の互換性

現在、Hibernate Search には後方互換性の API またはツールが含まれておらず、アプリケーションを新しいバージョンに移植することができます。API は、インデックスの書き込みおよび検索に Apache Lucene を使用します。インデックス形式の更新が必要になる場合があります。この場合、Lucene が古い形式を読み取れない場合は、データのインデックスを再作成する必要があります。

Hibernate Search は hibernate.search.lucene_version 設定プロパティーを公開します。このプロパティーは、旧バージョンの Lucene で定義されたように、Analyzly クラスおよびその他の Lucene クラスが動作に準拠するように指示します。lucene-core.jar に含まれる org.apache.lucene.util.Version も参照してください。このオプションが指定されていない場合、Hibernate Search は Lucene にバージョンのデフォルトを使用するように指示します。使用されるバージョンは、アップグレード時に自動的に変更されないように設定に明示的に定義することが推奨されます。アップグレード後、必要に応じて設定値を明示的に更新できます。

hibernate.search.lucene_version = LUCENE_30

hibernate.search.lucene_version = LUCENE_30

設定された SearchFactory はグローバルで、関連するパラメーターが含まれるすべての Lucene API に影響します。Lucene を使用し、Hibernate Search がバイパスされている場合は、一貫した結果を得るために同じ値をこれに適用します。