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.type
をsingle-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
キーワードの使用を停止してください。一部のユースケースでは、凍結層が凍結インデックスの適切な代替となる場合があります。詳細については、データ層を参照してください。