truncate #
Truncate the collection, removing all stored documents but keeping all associated mappings.
This method is a lot faster than removing all documents using multiple delete requests.
truncate([options], [callback]) #
Arguments | Type | Description |
---|---|---|
options | JSON Object | Optional parameters |
callback | function | Optional callback |
Options #
Option | Type | Description | Default |
---|---|---|---|
queuable | boolean | Make this request queuable or not | true |
refresh | string | If set to wait_for , Kuzzle will wait for the persistence layer to finish indexing (available with Elasticsearch 5.x and above) | undefined |
Return Value #
Returns the Collection
object to allow chaining.
Callback Response #
Returns a JSON object
containing the raw Kuzzle response.
Usage #
kuzzle
.collection("collection", "index")
.truncate(new ResponseListener<JSONObject>() {
@Override
public void onSuccess(JSONObject object) {
// callback called once the truncate operation has completed
// => the result is a JSON object containing the raw Kuzzle response
}
@Override
public void onError(JSONObject error) {
// Handle error
}
});
Callback response:
{
"status": 200,
"error": null,
"requestId": "8fdc0efb-6fc7-427d-a3a1-fd8cf5eabc20",
"controller": "admin",
"action": "truncateCollection",
"collection": "name of the truncated collection",
"index": "name of the index containing the truncated collection",
"volatile": {},
"state": "done",
"result": { "acknowledged": true }
}
Edit this page on Github(opens new window)