Force Merge APIedit
Force merge Requestedit
A ForceMergeRequest
can be applied to one or more indices, or even on _all
the indices:
Optional argumentsedit
Setting |
Synchronous Executionedit
ForceMergeResponse forceMergeResponse = client.indices().forcemerge(request, RequestOptions.DEFAULT);
Asynchronous Executionedit
The asynchronous execution of a force merge request requires both the ForceMergeRequest
instance and an ActionListener
instance to be passed to the asynchronous
method:
The asynchronous method does not block and returns immediately. Once it is
completed the ActionListener
is called back using the onResponse
method
if the execution successfully completed or using the onFailure
method if
it failed.
A typical listener for ForceMergeResponse
looks like:
Force Merge Responseedit
The returned ForceMergeResponse
allows to retrieve information about the
executed operation as follows:
int totalShards = forceMergeResponse.getTotalShards(); int successfulShards = forceMergeResponse.getSuccessfulShards(); int failedShards = forceMergeResponse.getFailedShards(); DefaultShardOperationFailedException[] failures = forceMergeResponse.getShardFailures();
Total number of shards hit by the force merge request |
|
Number of shards where the force merge has succeeded |
|
Number of shards where the force merge has failed |
|
A list of failures if the operation failed on one or more shards |
By default, if the indices were not found, an ElasticsearchException
will be thrown: