mirror of
https://github.com/honeymoose/OpenSearch.git
synced 2025-02-19 03:15:15 +00:00
89c65752dc
Previously the functions accepted a doc values reference, whereas they now accept the name of the vector field. Here's an example of how a vector function was called before and after the change. ``` Before: cosineSimilarity(params.query_vector, doc['field']) After: cosineSimilarity(params.query_vector, 'field') ``` This seems more intuitive, since we don't allow direct access to vector doc values and the the meaning of `doc['field']` is unclear. The PR makes the following changes (broken into distinct commits): * Add new function signatures of the form `function(params.query_vector, 'field')` and deprecates the old ones. Because Painless doesn't allow two methods with the same name and number of arguments, we allow a generic `Object` to be passed in to the function and decide on the behavior through an `instanceof` check. * Refactor the class bindings so that the document field is passed to the constructor instead of the instance method. This allows us to avoid retrieving the vector doc values on every function invocation, which gives a tiny speed-up in benchmarks. Note that this PR adds new signatures for the sparse vector functions too, even though sparse vectors are deprecated. It seemed simplest to understand (for both us and users) to keep everything symmetric between dense and sparse vectors.
38 lines
1.2 KiB
Plaintext
38 lines
1.2 KiB
Plaintext
[[breaking-changes-7.6]]
|
|
== Breaking changes in 7.6
|
|
++++
|
|
<titleabbrev>7.6</titleabbrev>
|
|
++++
|
|
|
|
This section discusses the changes that you need to be aware of when migrating
|
|
your application to Elasticsearch 7.6.
|
|
|
|
See also <<release-highlights>> and <<es-release-notes>>.
|
|
|
|
coming[7.6.0]
|
|
|
|
//NOTE: The notable-breaking-changes tagged regions are re-used in the
|
|
//Installation and Upgrade Guide
|
|
|
|
//tag::notable-breaking-changes[]
|
|
|
|
//end::notable-breaking-changes[]
|
|
|
|
[discrete]
|
|
[[breaking_76_search_changes]]
|
|
=== Search Changes
|
|
|
|
[discrete]
|
|
==== Deprecation of sparse vector fields
|
|
The `sparse_vector` field type has been deprecated and will be removed in 8.0.
|
|
We have not seen much interest in this experimental field type, and don't see
|
|
a clear use case as it's currently designed. If you have feedback or
|
|
suggestions around sparse vector functionality, please let us know through
|
|
GitHub or the 'discuss' forums.
|
|
|
|
[discrete]
|
|
==== Update to vector function signatures
|
|
The vector functions of the form `function(query, doc['field'])` are
|
|
deprecated, and the form `function(query, 'field')` should be used instead.
|
|
For example, `cosineSimilarity(query, doc['field'])` is replaced by
|
|
`cosineSimilarity(query, 'field')`. |