Skip to content

Commit 275fcbf

Browse files
author
elasticsearchmachine
committed
Forward port release notes for v8.17.0
1 parent 8f45b6b commit 275fcbf

File tree

2 files changed

+249
-2
lines changed

2 files changed

+249
-2
lines changed

docs/reference/migration/migrate_8_17.asciidoc

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,3 +18,54 @@ coming::[8.17.0]
1818

1919
There are no breaking changes in {es} 8.17.
2020

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

4-
coming[8.17.0]
5-
64
Also see <<breaking-changes-8.17,Breaking changes in 8.17>>.
75

6+
[[license-8.17.0]]
7+
[float]
8+
=== License changes
9+
10+
[float]
11+
==== Change to synthetic `_source` licensing
12+
13+
Starting with this release, the <<synthetic-source,synthetic `_source`>> feature is available exclusively with the Enterprise subscription. Synthetic `_source` is used in logs data streams (`logsdb` index mode), time series data streams (TSDS, using `time_series` index mode), application performance monitoring (APM), and Universal Profiling.
14+
15+
If you are using these capabilities and are not on an Enterprise license, the change will result in increased storage requirements for new data, as the synthetic `_source` setting will be ignored. Existing indices that used synthetic `_source` will remain seamlessly accessible.
16+
17+
Refer to the subscription page for https://www.elastic.co/subscriptions/cloud[Elastic Cloud] and {subscriptions}[Elastic Stack/self-managed] for the breakdown of available features and their associated subscription tiers. For further details and subscription options, contact your Elastic sales representative or https://www.elastic.co/contact[contact us].
18+
19+
[[bug-8.17.0]]
20+
[float]
21+
=== Bug fixes
22+
23+
Analysis::
24+
* Adjust analyze limit exception to be a `bad_request` {es-pull}116325[#116325]
25+
26+
CCS::
27+
* Fix long metric deserialize & add - auto-resize needs to be set manually {es-pull}117105[#117105] (issue: {es-issue}116914[#116914])
28+
29+
CRUD::
30+
* Standardize error code when bulk body is invalid {es-pull}114869[#114869]
31+
32+
Data streams::
33+
* Acquire stats searcher for data stream stats {es-pull}117953[#117953]
34+
35+
EQL::
36+
* Don't use a `BytesStreamOutput` to copy keys in `BytesRefBlockHash` {es-pull}114819[#114819] (issue: {es-issue}114599[#114599])
37+
38+
ES|QL::
39+
* Added stricter range type checks and runtime warnings for ENRICH {es-pull}115091[#115091] (issues: {es-issue}107357[#107357], {es-issue}116799[#116799])
40+
* Don't return TEXT type for functions that take TEXT {es-pull}114334[#114334] (issues: {es-issue}111537[#111537], {es-issue}114333[#114333])
41+
* ESQL: Fix sorts containing `_source` {es-pull}116980[#116980] (issue: {es-issue}116659[#116659])
42+
* ES|QL: Fix stats by constant expression {es-pull}114899[#114899]
43+
* Fix BWC for ES|QL cluster request {es-pull}117865[#117865]
44+
* Fix CCS exchange when multi cluster aliases point to same cluster {es-pull}117297[#117297]
45+
* Fix COUNT filter pushdown {es-pull}117503[#117503] (issue: {es-issue}115522[#115522])
46+
* Fix NPE in `EnrichLookupService` on mixed clusters with <8.14 versions {es-pull}116583[#116583] (issues: {es-issue}116529[#116529], {es-issue}116544[#116544])
47+
* Fix stats by constant expresson with alias {es-pull}117551[#117551]
48+
* Fix validation of SORT by aggregate functions {es-pull}117316[#117316]
49+
* Fixing remote ENRICH by pushing the Enrich inside `FragmentExec` {es-pull}114665[#114665] (issue: {es-issue}105095[#105095])
50+
* Ignore cancellation exceptions {es-pull}117657[#117657]
51+
* Limit size of `Literal#toString` {es-pull}117842[#117842]
52+
* Opt into extra data stream resolution {es-pull}118378[#118378]
53+
* Use `SearchStats` instead of field.isAggregatable in data node planning {es-pull}115744[#115744] (issue: {es-issue}115737[#115737])
54+
* [ESQL] Fix Binary Comparisons on Date Nanos {es-pull}116346[#116346]
55+
* [ES|QL] To_DatePeriod and To_TimeDuration return better error messages on `union_type` fields {es-pull}114934[#114934]
56+
57+
Infra/CLI::
58+
* Fix NPE on plugin sync {es-pull}115640[#115640] (issue: {es-issue}114818[#114818])
59+
60+
Ingest Node::
61+
* Fix enrich cache size setting name {es-pull}117575[#117575]
62+
* Fix log message format bugs {es-pull}118354[#118354]
63+
* Fix reconstituting version string from components {es-pull}117213[#117213] (issue: {es-issue}116950[#116950])
64+
* Reducing error-level stack trace logging for normal events in `GeoIpDownloader` {es-pull}114924[#114924]
65+
66+
License::
67+
* Distinguish `LicensedFeature` by family field {es-pull}116809[#116809]
68+
69+
Logs::
70+
* Prohibit changes to index mode, source, and sort settings during resize {es-pull}115812[#115812]
71+
72+
Machine Learning::
73+
* Fix deberta tokenizer bug caused by bug in normalizer {es-pull}117189[#117189]
74+
* Fix for Deberta tokenizer when input sequence exceeds 512 tokens {es-pull}117595[#117595]
75+
* Hides `hugging_face_elser` service from the `GET _inference/_services API` {es-pull}116664[#116664] (issue: {es-issue}116644[#116644])
76+
* Mitigate IOSession timeouts {es-pull}115414[#115414] (issues: {es-issue}114385[#114385], {es-issue}114327[#114327], {es-issue}114105[#114105], {es-issue}114232[#114232])
77+
* Propagate scoring function through random sampler {es-pull}116957[#116957] (issue: {es-issue}110134[#110134])
78+
* Wait for the worker service to shutdown before closing task processor {es-pull}117920[#117920] (issue: {es-issue}117563[#117563])
79+
80+
Mapping::
81+
* Address mapping and compute engine runtime field issues {es-pull}117792[#117792] (issue: {es-issue}117644[#117644])
82+
* Always Emit Inference ID in Semantic Text Mapping {es-pull}117294[#117294]
83+
* Fix concurrency issue with `ReinitializingSourceProvider` {es-pull}118370[#118370] (issue: {es-issue}118238[#118238])
84+
* Fix false positive date detection with trailing dot {es-pull}116953[#116953] (issue: {es-issue}116946[#116946])
85+
* Parse the contents of dynamic objects for [subobjects:false] {es-pull}117762[#117762] (issue: {es-issue}117544[#117544])
86+
87+
Network::
88+
* Use underlying `ByteBuf` `refCount` for `ReleasableBytesReference` {es-pull}116211[#116211]
89+
90+
Ranking::
91+
* Fix for propagating filters from compound to inner retrievers {es-pull}117914[#117914]
92+
93+
Search::
94+
* Add missing `async_search` query parameters to rest-api-spec {es-pull}117312[#117312]
95+
* Don't skip shards in coord rewrite if timestamp is an alias {es-pull}117271[#117271]
96+
* Fields caps does not honour ignore_unavailable {es-pull}116021[#116021] (issue: {es-issue}107767[#107767])
97+
* _validate does not honour ignore_unavailable {es-pull}116656[#116656] (issue: {es-issue}116594[#116594])
98+
99+
Vector Search::
100+
* Correct bit * byte and bit * float script comparisons {es-pull}117404[#117404]
101+
102+
Watcher::
103+
* Watch Next Run Interval Resets On Shard Move or Node Restart {es-pull}115102[#115102] (issue: {es-issue}111433[#111433])
104+
105+
[[deprecation-8.17.0]]
106+
[float]
107+
=== Deprecations
108+
109+
Infra/REST API::
110+
* Add a basic deprecation warning that the JSON format for non-detailed error responses is changing in v9 {es-pull}114739[#114739] (issue: {es-issue}89387[#89387])
111+
112+
Mapping::
113+
* Deprecate `_source.mode` in mappings {es-pull}116689[#116689]
114+
115+
[[enhancement-8.17.0]]
116+
[float]
117+
=== Enhancements
118+
119+
Authorization::
120+
* Add a `monitor_stats` privilege and allow that privilege for remote cluster privileges {es-pull}114964[#114964]
121+
122+
Data streams::
123+
* Adding a deprecation info API warning for data streams with old indices {es-pull}116447[#116447]
124+
125+
ES|QL::
126+
* Add ES|QL `bit_length` function {es-pull}115792[#115792]
127+
* ESQL: Honor skip_unavailable setting for nonmatching indices errors at planning time {es-pull}116348[#116348] (issue: {es-issue}114531[#114531])
128+
* ESQL: Remove parent from `FieldAttribute` {es-pull}112881[#112881]
129+
* ESQL: extract common filter from aggs {es-pull}115678[#115678]
130+
* ESQL: optimise aggregations filtered by false/null into evals {es-pull}115858[#115858]
131+
* ES|QL CCS uses `skip_unavailable` setting for handling disconnected remote clusters {es-pull}115266[#115266] (issue: {es-issue}114531[#114531])
132+
* ES|QL: add metrics for functions {es-pull}114620[#114620]
133+
* Esql Enable Date Nanos (tech preview) {es-pull}117080[#117080]
134+
* [ES|QL] Implicit casting string literal to intervals {es-pull}115814[#115814] (issue: {es-issue}115352[#115352])
135+
136+
Indices APIs::
137+
* Ensure class resource stream is closed in `ResourceUtils` {es-pull}116437[#116437]
138+
139+
Inference::
140+
* Add version prefix to Inference Service API path {es-pull}117366[#117366]
141+
* Update sparse text embeddings API route for Inference Service {es-pull}118368[#118368]
142+
143+
Infra/Core::
144+
* Support for unsigned 64 bit numbers in Cpu stats {es-pull}114681[#114681] (issue: {es-issue}112274[#112274])
145+
146+
Ingest Node::
147+
* Adding support for additional mapping to simulate ingest API {es-pull}114742[#114742]
148+
* Adding support for simulate ingest mapping adddition for indices with mappings that do not come from templates {es-pull}115359[#115359]
149+
150+
Logs::
151+
* Add logsdb telemetry {es-pull}115994[#115994]
152+
* Add num docs and size to logsdb telemetry {es-pull}116128[#116128]
153+
* Feature: re-structure document ID generation favoring _id inverted index compression {es-pull}104683[#104683]
154+
155+
Machine Learning::
156+
* Add special case for elastic reranker in inference API {es-pull}116962[#116962]
157+
* Adding inference endpoint validation for `AzureAiStudioService` {es-pull}113713[#113713]
158+
* Adds support for `input_type` field to Vertex inference service {es-pull}116431[#116431]
159+
* Enable built-in Inference Endpoints and default for Semantic Text {es-pull}116931[#116931]
160+
* Increase default `queue_capacity` to 10_000 and decrease max `queue_capacity` to 100_000 {es-pull}115041[#115041]
161+
* [Inference API] Add API to get configuration of inference services {es-pull}114862[#114862]
162+
* [Inference API] Improve chunked results error message {es-pull}115807[#115807]
163+
164+
Recovery::
165+
* Attempt to clean up index before remote transfer {es-pull}115142[#115142] (issue: {es-issue}104473[#104473])
166+
167+
Relevance::
168+
* Add query rules retriever {es-pull}114855[#114855]
169+
170+
Search::
171+
* Add Search Phase APM metrics {es-pull}113194[#113194]
172+
* Add `docvalue_fields` Support for `dense_vector` Fields {es-pull}114484[#114484] (issue: {es-issue}108470[#108470])
173+
* Add initial support for `semantic_text` field type {es-pull}113920[#113920]
174+
* Adds access to flags no_sub_matches and no_overlapping_matches to hyphenation-decompounder-tokenfilter {es-pull}115459[#115459] (issue: {es-issue}97849[#97849])
175+
* Better sizing `BytesRef` for Strings in Queries {es-pull}115655[#115655]
176+
* Enable `_tier` based coordinator rewrites for all indices (not just mounted indices) {es-pull}115797[#115797]
177+
178+
Vector Search::
179+
* Add support for bitwise inner-product in painless {es-pull}116082[#116082]
180+
* Improve halfbyte transposition performance, marginally improving bbq performance {es-pull}117350[#117350]
181+
182+
[[feature-8.17.0]]
183+
[float]
184+
=== New features
185+
186+
Data streams::
187+
* Add default ILM policies and switch to ILM for apm-data plugin {es-pull}115687[#115687]
188+
189+
ES|QL::
190+
* Add support for `BYTE_LENGTH` scalar function {es-pull}116591[#116591]
191+
* Esql/lookup join grammar {es-pull}116515[#116515]
192+
* Remove snapshot build restriction for match and qstr functions {es-pull}114482[#114482]
193+
194+
Search::
195+
* ESQL - Add match operator (:) {es-pull}116819[#116819]
196+
197+
[[upgrade-8.17.0]]
198+
[float]
199+
=== Upgrades
200+
201+
Security::
202+
* Upgrade Bouncy Castle FIPS dependencies {es-pull}112989[#112989]
203+
8204

0 commit comments

Comments
 (0)