Skip to content

Commit da0a969

Browse files
committed
Document breaking change around _id field data.
1 parent 1b9fe12 commit da0a969

File tree

2 files changed

+10
-6
lines changed

2 files changed

+10
-6
lines changed

docs/reference/migration/migrate_7_6.asciidoc

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ specify a role descriptor with no privileges:
3535
[source,js]
3636
----
3737
...
38-
"role_descriptors": {
38+
"role_descriptors": {
3939
"no-privilege": {
4040
}
4141
}
@@ -49,6 +49,14 @@ specify a role descriptor with no privileges:
4949
[[breaking_76_search_changes]]
5050
=== Search changes
5151

52+
[discrete]
53+
==== Aggregating and sorting on `_id` is deprecated
54+
It's possible to aggregate and sort on the built-in `_id` field by loading an
55+
expensive data structure called fielddata. This was deprecated in 7.6 and will
56+
be disallowed by default in 8.0. As an alternative, the `_id` field's contents
57+
can be duplicated into another field with docvalues enabled (note that this
58+
does not apply to auto-generated IDs).
59+
5260
[discrete]
5361
==== Deprecation of sparse vector fields
5462
The `sparse_vector` field type has been deprecated and will be removed in 8.0.

docs/reference/release-notes/7.6.asciidoc

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -189,11 +189,6 @@ This issue is fixed in {es} 7.7.0 and later versions (issue: {es-issue}50916[#50
189189
[discrete]
190190
=== Breaking changes
191191

192-
Mapping::
193-
* Add a cluster setting to disallow loading fielddata on _id field {es-pull}49166[#49166] (issues: {es-issue}26472[#26472], {es-issue}43599[#43599])
194-
195-
196-
197192
[[breaking-java-7.6.0]]
198193
[discrete]
199194
=== Breaking Java changes
@@ -228,6 +223,7 @@ Reindex::
228223
* Deprecate sorting in reindex {es-pull}49458[#49458] (issue: {es-issue}47567[#47567])
229224

230225
Search::
226+
* Deprecate loading fielddata on _id field {es-pull}49166[#49166] (issues: {es-issue}26472[#26472], {es-issue}43599[#43599])
231227
* Update the signature of vector script functions. {es-pull}48604[#48604]
232228
* Deprecate the sparse_vector field type. {es-pull}48315[#48315]
233229
* Add a deprecation warning regarding allocation awareness in search request {es-pull}48351[#48351] (issue: {es-issue}43453[#43453])

0 commit comments

Comments
 (0)