Skip to content

Commit 31eccf7

Browse files
author
elasticsearchmachine
committed
Forward port release notes for v8.17.2
1 parent cf64bd3 commit 31eccf7

File tree

3 files changed

+141
-6
lines changed

3 files changed

+141
-6
lines changed

‎docs/reference/migration/migrate_8_17.asciidoc‎

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
[[migrating-8.17]]
2+
== Migrating to 8.17
3+
++++
4+
<titleabbrev>8.17</titleabbrev>
5+
++++
6+
7+
This section discusses the changes that you need to be aware of when migrating
8+
your application to {es} 8.17.
9+
10+
See also <<release-highlights>> and <<es-release-notes>>.
11+
12+
[discrete]
13+
[[breaking-changes-8.17]]
14+
=== Breaking changes
15+
16+
There are no breaking changes in {es} 8.17.
17+
18+
19+
[discrete]
20+
[[deprecated-8.17]]
21+
=== Deprecations
22+
23+
The following functionality has been deprecated in {es} 8.17
24+
and will be removed in a future version.
25+
While this won't have an immediate impact on your applications,
26+
we strongly encourage you to take the described steps to update your code
27+
after upgrading to 8.17.
28+
29+
To find out if you are using any deprecated functionality,
30+
enable <<deprecation-logging, deprecation logging>>.
31+
32+
[discrete]
33+
[[deprecations_817_mapping]]
34+
==== Mapping deprecations
35+
36+
[[deprecate_source_mode_in_mappings]]
37+
.Deprecate `_source.mode` in mappings
38+
[%collapsible]
39+
====
40+
*Details* +
41+
Configuring `_source.mode` in mappings is deprecated and will be removed in future versions. Use `index.mapping.source.mode` index setting instead.
42+
43+
*Impact* +
44+
Use `index.mapping.source.mode` index setting instead
45+
====
46+
47+
[discrete]
48+
[[deprecations_817_rest_api]]
49+
==== REST API deprecations
50+
51+
[[format_of_non_detailed_error_responses_changing_in_v9]]
52+
.The format of non-detailed error responses is changing in v9
53+
[%collapsible]
54+
====
55+
*Details* +
56+
When an error occurs when processing a request, Elasticsearch returns information on that error in the REST response.
57+
If `http:detailed_errors.enabled: false` is specified in node settings with the v8 REST API and below,
58+
the format of this response changes significantly.
59+
Starting with the v9 REST API, the JSON structure of responses with errors when the `http.detailed_errors.enabled: false` option is set
60+
will be the same as when detailed errors are enabled (which is the default).
61+
To keep using the existing format for non-detailed error responses, use the v8 REST API.
62+
63+
*Impact* +
64+
If you have set `http.detailed_errors.enabled: false` (the default is `true`)
65+
the structure of JSON when any exceptions occur will change with the v9 REST API.
66+
To keep using the existing format, use the v8 REST API.
67+
====
68+

‎docs/reference/release-notes/8.17.2.asciidoc‎

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
[[release-notes-8.17.2]]
2+
== {es} version 8.17.2
3+
4+
Also see <<breaking-changes-8.17,Breaking changes in 8.17>>.
5+
6+
[[bug-8.17.2]]
7+
[float]
8+
=== Bug fixes
9+
10+
Authentication::
11+
* Fix NPE on disabled API auth key cache {es-pull}120483[#120483]
12+
13+
Data streams::
14+
* Map `scope.name` as a dimension {es-pull}120590[#120590]
15+
16+
ES|QL::
17+
* Use `field_caps` native nested fields filtering {es-pull}117201[#117201] (issue: {es-issue}117054[#117054])
18+
19+
Machine Learning::
20+
* Fix infer on and elasticsearch service endpoint created with a deployment id {es-pull}121428[#121428]
21+
* Fix inference update API calls with `task_type` in body or `deployment_id` defined {es-pull}121231[#121231]
22+
* Skip Usage stats update when ML is disabled {es-pull}121559[#121559] (issue: {es-issue}121532[#121532])
23+
24+
Mapping::
25+
* Fix synthetic source issue with deeply nested ignored source fields {es-pull}121715[#121715]
26+
* Lower `_source.mode` mapping attribute deprecation issue level {es-pull}120059[#120059]
27+
28+
Ranking::
29+
* Fix LTR rescorer throws 'local model reference is null' on multi-shards index when explained is enabled {es-pull}120717[#120717] (issue: {es-issue}120739[#120739])
30+
* LTR sometines throw `NullPointerException:` Cannot read field "approximation" because "top" is null {es-pull}120809[#120809]
31+
* Normalize negative scores for `text_similarity_reranker` retriever {es-pull}120930[#120930] (issue: {es-issue}120201[#120201])
32+
* Update Text Similarity Reranker to Properly Handle Aliases {es-pull}120062[#120062] (issue: {es-issue}119617[#119617])
33+
34+
Search::
35+
* Add back `keep_alive` to `async_search.submit` rest-api-spec {es-pull}120781[#120781]
36+
* Fix NPE caused by race condition in async search when minimise round trips is true {es-pull}117504[#117504]
37+
* Fix potential file leak in ES816BinaryQuantizedVectorsWriter {es-pull}120014[#120014] (issue: {es-issue}119981[#119981])
38+
* Use approximation to advance matched queries {es-pull}120133[#120133] (issue: {es-issue}120130[#120130])
39+
40+
Snapshot/Restore::
41+
* Cheaper snapshot-related `toString()` impls {es-pull}121283[#121283]
42+
* Issue S3 web identity token refresh call with sufficient permissions {es-pull}119748[#119748] (issue: {es-issue}119747[#119747])
43+
44+
[[enhancement-8.17.2]]
45+
[float]
46+
=== Enhancements
47+
48+
Ingest Node::
49+
* Improve memory aspects of enrich cache {es-pull}120256[#120256] (issues: {es-issue}96050[#96050], {es-issue}120021[#120021])
50+
51+

‎docs/reference/release-notes/highlights.asciidoc‎

Lines changed: 22 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -15,13 +15,29 @@ Other versions:
1515

1616
endif::[]
1717

18-
// The notable-highlights tag marks entries that
19-
// should be featured in the Stack Installation and Upgrade Guide:
2018
// tag::notable-highlights[]
21-
// [discrete]
22-
// === Heading
23-
//
24-
// Description.
19+
20+
[discrete]
21+
[[add_new_experimental_rank_vectors_mapping_for_late_interaction_second_order_ranking]]
22+
=== Add new experimental `rank_vectors` mapping for late-interaction second order ranking
23+
Late-interaction models are powerful rerankers. While their size and overall cost doesn't lend itself for HNSW indexing, utilizing them as second order reranking can provide excellent boosts in relevance. The new `rank_vectors` mapping allows for rescoring over new and novel multi-vector late-interaction models like ColBERT or ColPali.
24+
25+
{es-pull}118804[#118804]
26+
27+
[discrete]
28+
[[enable_lookup_join_in_non_snapshot_builds]]
29+
=== Enable LOOKUP JOIN in non-snapshot builds
30+
This effectively releases LOOKUP JOIN into tech preview. Docs will
31+
follow in a separate PR.
32+
33+
- Enable the lexing/grammar for LOOKUP JOIN in non-snapshot builds.
34+
- Remove the grammar for the unsupported `| JOIN ...` command (without `LOOKUP` as first keyword). The way the lexer modes work, otherwise we'd also have to enable `| JOIN ...` syntax on non-snapshot builds and would have to add additional validation to provide appropriate error messages.
35+
- Remove grammar for `LOOKUP JOIN index AS ...` because qualifiers are not yet supported. Otherwise we'd have to put in additional validation as well to prevent such queries.
36+
37+
Also fix https://github.com/elastic/elasticsearch/issues/121185
38+
39+
{es-pull}121193[#121193]
40+
2541
// end::notable-highlights[]
2642

2743

0 commit comments

Comments
 (0)