8.6 への移行

このセクションでは、アプリケーションを Elasticsearch 8.6 に移行する際に注意すべき変更点について説明します。

詳細については、8.15 の新機能 および リリースノート を参照してください。

破壊的変更

Elasticsearch 8.6 には破壊的変更はありません。

非推奨機能

以下の機能は Elasticsearch 8.6 で非推奨となり、将来のバージョンで削除される予定です。これにより、アプリケーションに即座の影響はありませんが、8.6 にアップグレードした後は、記載された手順に従ってコードを更新することを強くお勧めします。

非推奨機能を使用しているかどうかを確認するには、非推奨ログ記録を有効にしてください。

CRUD 非推奨機能

インジェストアタッチメントプロセッサの remove_binary のデフォルトを false から非推奨にする

詳細

アタッチメントプロセッサのデフォルトの「remove_binary」オプションは、後の Elasticsearch リリースで false から true に変更されます。これは、Elasticsearch に送信されたバイナリファイルが保持されないことを意味します。

影響

ユーザーは、「remove_binary」オプションを明示的に true または false に更新する必要があります。デフォルト値に依存するのではなく、デフォルト値の変更が Elasticsearch に影響を与えないようにしてください。

クラスタおよびノード設定の非推奨機能

バランスの閾値が少なくとも 1 であることを確認してください

詳細

cluster.routing.allocation.balance.threshold より小さい値は 1 で無視されるようになりました。この設定に対する 1 より小さい値のサポートは非推奨となり、将来のバージョンで禁止されます。

影響

cluster.routing.allocation.balance.threshold を少なくとも 1 に設定してください。

マッピングの非推奨機能

メタデータフィールド定義における type、fields、copy_to および boost の無視を非推奨にする

詳細

type、fields、copy_to および boost のようなサポートされていないパラメータは、インデックスマッピングのメタデータフィールドの構成の一部として提供された場合、静かに無視されます。これらは、8.6 以降に作成されたインデックスのマッピングで使用されると、非推奨警告を引き起こします。

影響

非推奨警告を解決するには、インデックスマッピングの一部として、メタデータフィールド定義から type、fields、copy_to または boost の言及を削除してください。これらは効果がないため、削除しても非推奨警告を解決する以外の影響はありません。

REST API の非推奨機能

/_cluster/reroute の応答における state フィールドは非推奨です

詳細

state フィールドは /_cluster/reroute の応答で非推奨です。クラスタの状態は、reroute/commands の実行結果に関する有意義な情報を提供しません。この正確な状態が適用される保証はありません。

影響

Reroute API のユーザーは state フィールドに依存せず、代わりに explain を使用してコマンド実行の結果を要求するべきです。