Skip to content

Commit c22554d

Browse files
authored
(Doc+) Split API
👋 howdy, ES Dev! Will you kindly confirm for [Split API](https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-split-index.html) doc 1. Current doc states ... . My belief is that we're telling customers they need sufficient disk on each node hosting primary shards of the index which are going to be split out. AFAICT the doc does not currently otherwise help users judge which node will "handle the split process" which could randomly be master-only in which case this callout would feel wrong. > The node handling the split process must have sufficient free disk space to accommodate a second copy of the existing index. 2. If Elastic Cloud [hard-link not supported](https://support.elastic.dev/knowledge/view/d2cd7697) (internal link) restriction is ongoing? 🙏 TIA!
1 parent 78890e9 commit c22554d

File tree

1 file changed

+5
-1
lines changed

1 file changed

+5
-1
lines changed

docs/reference/indices/split-index.asciidoc

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -121,11 +121,15 @@ newly split index.
121121
A split operation:
122122

123123
. Creates a new target index with the same definition as the source
124-
index, but with a larger number of primary shards.
124+
index, but with a larger number of primary shards. Created shards allocate
125+
to the same nodes as their correlating source primary shard, so it must
126+
already have sufficient disk to host the copy of the data.
125127

126128
. Hard-links segments from the source index into the target index. (If
127129
the file system doesn't support hard-linking, then all segments are copied
128130
into the new index, which is a much more time consuming process.)
131+
+
132+
TIP: Elastic Cloud's backing file systems do not support hard linking.
129133

130134
. Hashes all documents again, after low level files are created, to delete
131135
documents that belong to a different shard.

0 commit comments

Comments
 (0)