Skip to content

Commit 79c267f

Browse files
authored
Document breaking change around _id field data. (#64610)
1 parent 620cd16 commit 79c267f

File tree

1 file changed

+16
-2
lines changed

1 file changed

+16
-2
lines changed

docs/reference/migration/migrate_8_0/search.asciidoc

Lines changed: 16 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,20 @@
66
//Installation and Upgrade Guide
77

88
//tag::notable-breaking-changes[]
9+
[[id-field-data]]
10+
.Aggregating and sorting on `_id` is disallowed by default.
11+
[%collapsible]
12+
====
13+
*Details* +
14+
Previously, it was possible to aggregate and sort on the built-in `_id` field
15+
by loading an expensive data structure called fielddata. This was deprecated
16+
in 7.6 and is now disallowed by default in 8.0.
17+
18+
*Impact* +
19+
Aggregating and sorting on `_id` should be avoided. As an alternative, the
20+
`_id` field's contents can be duplicated into another field with docvalues
21+
enabled (note that this does not apply to auto-generated IDs).
22+
====
923
//end::notable-breaking-changes[]
1024

1125
.Search-related REST API endpoints containing mapping types have been removed.
@@ -82,7 +96,7 @@ suggestions around sparse vector functionality, please let us know through
8296
GitHub or the 'discuss' forums.
8397
8498
*Impact* +
85-
Discontinue use of the `sparse_vector` field data type. Requests containing
99+
Discontinue use of the `sparse_vector` field data type. Requests containing
86100
a mapping for this field data type will return an error.
87101
====
88102

@@ -142,4 +156,4 @@ an error already. We now also reject `-1` as an invalid value.
142156
Change any use of `-1` as `from` parameter in request body or url parameters by either
143157
setting it to `0` or omitting it entirely. Requests containing negative values will
144158
return an error.
145-
====
159+
====

0 commit comments

Comments
 (0)