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 #
<?php
use \Kuzzle\Kuzzle;
$kuzzle = new Kuzzle('localhost');
$dataCollection = $kuzzle->collection('collection', 'index');
try {
$dataCollection->truncate();
}
catch (ErrorException $e) {
}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 }
}