elasticsearch/docs/reference/migration/migrate_8_9.asciidoc
Ryan Ernst 97d19a3881
Add release notes for 8.9.0 release (#97061) (#97931)
Co-authored-by: Abdon Pijpelink <abdon.pijpelink@elastic.co>
Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
Co-authored-by: David Kyle <david.kyle@elastic.co>
Co-authored-by: James Rodewig <james.rodewig@elastic.co>
2023-07-25 07:00:03 -07:00

42 lines
1.6 KiB
Text

[[migrating-8.9]]
== Migrating to 8.9
++++
<titleabbrev>8.9</titleabbrev>
++++
This section discusses the changes that you need to be aware of when migrating
your application to {es} 8.9.
See also <<release-highlights>> and <<es-release-notes>>.
coming::[8.9.0]
[discrete]
[[breaking-changes-8.9]]
=== Breaking changes
The following changes in {es} 8.9 might affect your applications
and prevent them from operating normally.
Before upgrading to 8.9, review these changes and take the described steps
to mitigate the impact.
// NOTE: The notable-breaking-changes tagged regions are re-used in the
// Installation and Upgrade Guide
// tag::notable-breaking-changes[]
[discrete]
[[breaking_89_rest_api_changes]]
==== REST API changes
[[switch_tdigeststate_to_use_hybriddigest_by_default]]
.Switch TDigestState to use `HybridDigest` by default
[%collapsible]
====
*Details* +
The default implementation for TDigest in percentile calculations switches to a new internal implementation offering superior performance (2x-10x speedup), at a very small accuracy penalty for very large sample populations.
*Impact* +
This change leads to generating slightly different results in percentile calculations. If the highest possible accuracy is desired, or it's crucial to produce exactly the same results as in previous versions, one can either set `execution_hint` to `high_accuracy` in the `tdigest` spec of a given percentile calculation, or set `search.aggs.tdigest_execution_hint` to `high_accuracy` in cluster settings to apply to all percentile queries.
====
// end::notable-breaking-changes[]