8.1への移行

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

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

破壊的変更

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

REST APIの変更

検索APIのfieldsパラメータは、国際日付変更線を越えるジオメトリオブジェクトを正規化します。

詳細

検索APIのfieldsパラメータは、国際日付変更線(+/-180°経度)を越えるgeo_shapeオブジェクトを正規化します。たとえば、ポリゴンが日付変更線を越える場合、fieldsパラメータはそれを2つのポリゴンとして返します。元の正規化されていないジオメトリオブジェクトは_sourceから取得できます。

影響

アプリケーションが正規化されていないジオメトリオブジェクトを必要とする場合は、_sourceから取得し、fieldsパラメータを使用しないでください。

非推奨機能

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

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

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

discovery.type設定のレガシー値は非推奨です。

詳細

discovery.type設定のレガシー値は非推奨であり、将来のバージョンで禁止されます。

影響

discovery.typesingle-nodeまたはmulti-node以外の値に設定しないでください。他のすべての値は、デフォルトの発見タイプであるmulti-nodeと同等です。可能な場合は、この設定を省略してElasticsearchがデフォルトの発見タイプを使用するようにしてください。

REST APIの非推奨

バルクアクションの寛容な解析は非推奨です。

詳細

古いバージョンのElasticsearchは、バルクリクエストのアクションラインを非常に寛容に解析し、無効または不正なアクションを静かに無視していました。この寛容さは非推奨であり、将来のバージョンでは無効なアクションを含むバルクリクエストを拒否します。

影響

バルクアクションが正しいキーを持つ単一のエントリを含む適切なJSONオブジェクトであることを確認してください。

index_include_frozenリクエストパラメータを_sql APIで非推奨にします。

詳細

凍結インデックスの非推奨に続いて、index_include_frozenパラメータとFROZEN構文も非推奨となりました。

影響

インデックスの凍結解除APIを使用して凍結されたインデックスの凍結を解除し、index_include_frozenパラメータまたはSQLクエリのFROZENキーワードの使用を停止してください。一部のユースケースでは、凍結層が凍結インデックスの適切な代替となる場合があります。詳細については、データ層を参照してください。