From c0b2ef55b8a5dbc38e652c8eb3a66a36e11f1acf Mon Sep 17 00:00:00 2001 From: Nik Everett Date: Thu, 5 Jul 2018 16:24:03 -0400 Subject: [PATCH] Docs: Explain _bulk?refresh shard targeting Only the shards that receive the bulk request will be affected by `refresh`. Imagine a `_bulk?refresh=wait_for` request with three documents in it that happen to be routed to different shards in an index with five shards. The request will only wait for those three shards to refresh. The other two shards of that make up the index do not participate in the `_bulk` request at all. Relates to #31819 --- docs/reference/docs/bulk.asciidoc | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/reference/docs/bulk.asciidoc b/docs/reference/docs/bulk.asciidoc index adf48bb0c76..4c6e55af318 100644 --- a/docs/reference/docs/bulk.asciidoc +++ b/docs/reference/docs/bulk.asciidoc @@ -230,6 +230,13 @@ example. Control when the changes made by this request are visible to search. See <>. +NOTE: Only the shards that receive the bulk request will be affected by +`refresh`. Imagine a `_bulk?refresh=wait_for` request with three +documents in it that happen to be routed to different shards in an index +with five shards. The request will only wait for those three shards to +refresh. The other two shards of that make up the index do not +participate in the `_bulk` request at all. + [float] [[bulk-update]] === Update