Skip to content

Commit 9b1534b

Browse files
committed
Update breaking changes doc with changes to geo_shape defaults
This commit updates the breaking changes doc to highlight the impact of changing geo_shape defaults on timed index creation.
1 parent 8f736c3 commit 9b1534b

File tree

1 file changed

+8
-4
lines changed

1 file changed

+8
-4
lines changed

docs/reference/migration/migrate_7_0/mappings.asciidoc

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -54,13 +54,17 @@ An error will now be thrown when unknown configuration options are provided
5454
to similarities. Such unknown parameters were ignored before.
5555

5656
[float]
57-
==== deprecated `geo_shape` Prefix Tree indexing
57+
==== Changed default `geo_shape` indexing strategy
5858

5959
`geo_shape` types now default to using a vector indexing approach based on Lucene's new
6060
`LatLonShape` field type. This indexes shapes as a triangular mesh instead of decomposing
61-
them into individual grid cells. To index using legacy prefix trees `recursive` or `term`
62-
strategy must be explicitly defined. Note that these strategies are now deprecated and will
63-
be removed in a future version.
61+
them into individual grid cells. To index using legacy prefix trees the `tree` parameter
62+
must be explicitly set to one of `quadtree` or `geohash`. Note that these strategies are
63+
now deprecated and will be removed in a future version.
64+
65+
IMPORTANT NOTE: If using timed index creation from templates, the `geo_shape` mapping
66+
should also be changed in the template to explicitly define `tree` to one of `geohash`
67+
or `quadtree`. This will ensure compatibility with previously created indexes.
6468

6569
[float]
6670
==== deprecated `geo_shape` parameters

0 commit comments

Comments
 (0)