8.5への移行

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

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

破壊的変更

Elasticsearch 8.5の以下の変更は、アプリケーションに影響を与え、正常に動作しなくなる可能性があります。8.5にアップグレードする前に、これらの変更を確認し、影響を軽減するために説明された手順を実行してください。

REST APIの変更

バルクAPIは、認識されていないアクションを含むリクエストを拒否します。

詳細

バルクAPIへのリクエストは、各アイテムがアイテムを説明するJSONオブジェクトで始まる一連のアイテムで構成されます。このオブジェクトには、create、update、index、またはdeleteのいずれかであるアイテムに対して実行するアクションのタイプが含まれています。以前のバージョンのElasticsearchには、認識されていないタイプのアイテムを無視し、リクエストの次の行をスキップするバグがありましたが、この寛容な動作により、クライアントがレスポンス内のアイテムをリクエスト内のアイテムに関連付ける方法がなくなり、場合によってはリクエストの残りの部分が不正に解析される原因となることがありました。

バージョン8.5以降、バルクAPIへのリクエストは、認識されたタイプのアイテムのみで構成されなければなりません。Elasticsearchは、認識されていないタイプのアイテムを含むリクエストを400 Bad Requestエラー応答で拒否します。

この変更はバグ修正と見なしていますが、認識されていないアクションをElasticsearchに送信できることに依存するアプリケーションの動作に影響を与える可能性があるため、ここに破壊的変更としてリストしています。

影響

アプリケーションがバルクAPIにcreate、update、index、またはdeleteのタイプのアイテムのみを送信することを確認してください。

非推奨機能

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

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

プラグインAPIの非推奨

NetworkPluginインターフェースを拡張するプラグインは非推奨です。

詳細

詳細

プラグインは、ノードがTCP/IPを介して他のノードと接続する方法を制御する機能をオーバーライドすることがあります。これらのプラグインはNetworkPluginインターフェースを拡張します。次の主要リリースでは、これらのプラグインはインストールに失敗します。

影響

NetworkPluginを拡張するプラグインの使用を中止してください。非推奨機能を使用しているプラグインがあるかどうかは、Elasticsearchの非推奨ログを確認することで確認できます。

DiscoveryPluginを拡張して参加バリデーターや選挙戦略をオーバーライドすることは非推奨です。

詳細

DiscoveryPluginを拡張するプラグインは、getJoinValidatorおよびgetElectionStrategiesをオーバーライドすることがあります。これらのメソッドは、Elasticsearch内のクラスタリングメカニズムの実装の詳細です。これらはオーバーライドすべきではありません。次の主要リリースでは、getJoinValidatorまたはgetElectionStrategiesをオーバーライドするプラグインはインストールに失敗します。

影響

DiscoveryPlugin内でgetJoinValidatorまたはgetElectionStrategiesをオーバーライドするプラグインの使用を中止してください。非推奨機能を使用しているプラグインがあるかどうかは、Elasticsearchの非推奨ログを確認することで確認できます。