OpenSearch/docs/reference/indices
Simon Willnauer bd7efa908a Add ability to split shards (#26931)
This change adds a new `_split` API that allows to split indices into a new
index with a power of two more shards that the source index.  This API works
alongside the `_shrink` API but doesn't require any shard relocation before
indices can be split.

The split operation is conceptually an inverse `_shrink` operation since we
initialize the index with a _syntetic_ number of routing shards that are used
for the consistent hashing at index time. Compared to indices created with
earlier versions this might produce slightly different shard distributions but
has no impact on the per-index backwards compatibility.  For now, the user is
required to prepare an index to be splittable by setting the
`index.number_of_routing_shards` at index creation time.  The setting allows the
user to prepare the index to be splittable in factors of
`index.number_of_routing_shards` ie. if the index is created with
`index.number_of_routing_shards: 16` and `index.number_of_shards: 2` it can be
split into `4, 8, 16` shards. This is an intermediate step until we can make
this the default. This also allows us to safely backport this change to 6.x.

The `_split` operation is implemented internally as a DeleteByQuery on the
lucene level that is executed while the primary shards execute their initial
recovery. Subsequent merges that are triggered due to this operation will not be
executed immediately. All merges will be deferred unti the shards are started
and will then be throttled accordingly.

This change is intended for the 6.1 feature release but will not support pre-6.1
indices to be split unless these indices have been shrunk before. In that case
these indices can be split backwards into their original number of shards.
2017-11-06 11:37:55 +01:00
..
aliases.asciidoc Remove usage of multi-types from the docs and added a page explaining type removal (#25543) 2017-07-05 12:30:19 +02:00
analyze.asciidoc Update experimental labels in the docs (#25727) 2017-07-18 14:06:22 +02:00
clearcache.asciidoc Add CONSOLE to a few snippets in reference docs 2016-09-01 13:08:36 -04:00
create-index.asciidoc Remove usage of multi-types from the docs and added a page explaining type removal (#25543) 2017-07-05 12:30:19 +02:00
delete-index.asciidoc [DOCS] delete index no longer supports specifying aliases 2017-06-19 10:30:05 +02:00
flush.asciidoc Introduce a History UUID as a requirement for ops based recovery (#26577) 2017-09-14 21:25:02 +03:00
forcemerge.asciidoc Add CONSOLE to a few snippets in reference docs 2016-09-01 13:08:36 -04:00
get-field-mapping.asciidoc Consilify get-field-mapping docs (#22936) 2017-02-03 10:04:31 +01:00
get-index.asciidoc Remove comma-separated feature parsing for GetIndicesAction 2017-06-02 14:43:38 -06:00
get-mapping.asciidoc Fix get mappings HEAD requests 2017-06-11 14:58:56 -04:00
get-settings.asciidoc CONSOLEify some more Indices APIs (#24375) 2017-05-01 13:56:39 -04:00
indices-exists.asciidoc Switch indices.exists_type from `{index}/{type}` to `{index}/_mapping/{type}`. #20055 2016-08-19 09:18:24 +02:00
open-close.asciidoc Add wait_for_active_shards parameter to index open command (#26682) 2017-09-22 11:15:03 +02:00
put-mapping.asciidoc Remove usage of multi-types from the docs and added a page explaining type removal (#25543) 2017-07-05 12:30:19 +02:00
recovery.asciidoc [Docs] Convert more doc snippets (#26359) 2017-08-28 11:23:09 +02:00
refresh.asciidoc Add CONSOLE to more docs 2016-09-01 17:08:18 -04:00
rollover-index.asciidoc Add size-based condition to the index rollover API (#27160) 2017-11-04 19:51:48 -04:00
segments.asciidoc [Docs] Convert more doc snippets (#26359) 2017-08-28 11:23:09 +02:00
shard-stores.asciidoc [Docs] Convert more doc snippets (#26359) 2017-08-28 11:23:09 +02:00
shrink-index.asciidoc Switch more docs to CONSOLE 2016-09-02 18:22:30 -04:00
split-index.asciidoc Add ability to split shards (#26931) 2017-11-06 11:37:55 +01:00
stats.asciidoc Switch more docs to CONSOLE 2016-09-02 18:22:30 -04:00
templates.asciidoc Reformat paragraph in template docs to 80 columns 2017-10-12 17:52:43 -04:00
types-exists.asciidoc Switch indices.exists_type from `{index}/{type}` to `{index}/_mapping/{type}`. #20055 2016-08-19 09:18:24 +02:00
update-settings.asciidoc documentation of preserve existing settings 2017-05-08 12:05:01 +02:00