Class yii\elasticsearch\BatchQueryResult
| Inheritance | yii\elasticsearch\BatchQueryResult » yii\base\BaseObject |
|---|---|
| Implements | Iterator |
| Available since version | 2.0.4 |
BatchQueryResult represents a batch query from which you can retrieve data in batches.
You usually do not instantiate BatchQueryResult directly. Instead, you obtain it by calling yii\elasticsearch\Query::batch() or yii\elasticsearch\Query::each(). Because BatchQueryResult implements the Iterator interface, you can iterate it to obtain a batch of data in each iteration.
Batch size is determined by the yii\elasticsearch\Query::$limit setting. yii\elasticsearch\Query::$offset setting is ignored. New batches will be obtained until the server runs out of results.
If yii\elasticsearch\Query::$orderBy parameter is not set, batches will be processed using the highly efficient "scan" mode. In this case, yii\elasticsearch\Query::$limit setting determines batch size per shard. See elasticsearch guide for more information.
Example:
`php
$query = (new Query)->from('user');
foreach ($query->batch() as $i => $users) {
// $users represents the rows in the $i-th batch
}
foreach ($query->each() as $user) {
}
`
Public Properties
| Property | Type | Description | Defined By |
|---|---|---|---|
| $db | yii\elasticsearch\Connection | The DB connection to be used when performing batch query. | yii\elasticsearch\BatchQueryResult |
| $each | boolean | Whether to return a single row during each iteration. | yii\elasticsearch\BatchQueryResult |
| $query | yii\elasticsearch\Query | The query object associated with this batch query. | yii\elasticsearch\BatchQueryResult |
| $scrollWindow | string | The amount of time to keep the scroll window open (in ElasticSearch [time units](https://www. | yii\elasticsearch\BatchQueryResult |
Public Methods
| Method | Description | Defined By |
|---|---|---|
| __destruct() | Destructor. | yii\elasticsearch\BatchQueryResult |
| current() | Returns the current dataset. | yii\elasticsearch\BatchQueryResult |
| key() | Returns the index of the current dataset. | yii\elasticsearch\BatchQueryResult |
| next() | Moves the internal pointer to the next dataset. | yii\elasticsearch\BatchQueryResult |
| reset() | Resets the batch query. | yii\elasticsearch\BatchQueryResult |
| rewind() | Resets the iterator to the initial state. | yii\elasticsearch\BatchQueryResult |
| valid() | Returns whether there is a valid dataset at the current position. | yii\elasticsearch\BatchQueryResult |
Protected Methods
| Method | Description | Defined By |
|---|---|---|
| fetchData() | Fetches the next batch of data. | yii\elasticsearch\BatchQueryResult |
Property Details
The DB connection to be used when performing batch query.
If null, the elasticsearch application component will be used.
Whether to return a single row during each iteration. If false, a whole batch of rows will be returned in each iteration.
The query object associated with this batch query. Do not modify this property directly unless after reset() is called explicitly.
The amount of time to keep the scroll window open (in ElasticSearch time units.
Method Details
Destructor.
| public void __destruct ( ) |
Returns the current dataset.
This method is required by the interface Iterator.
| public mixed current ( ) | ||
| return | mixed | The current dataset. |
|---|---|---|
Fetches the next batch of data.
| protected array fetchData ( ) | ||
| return | array | The data fetched |
|---|---|---|
Returns the index of the current dataset.
This method is required by the interface Iterator.
| public integer key ( ) | ||
| return | integer | The index of the current row. |
|---|---|---|
Moves the internal pointer to the next dataset.
This method is required by the interface Iterator.
| public void next ( ) |
Resets the batch query.
This method will clean up the existing batch query so that a new batch query can be performed.
| public void reset ( ) |
Resets the iterator to the initial state.
This method is required by the interface Iterator.
| public void rewind ( ) |
Returns whether there is a valid dataset at the current position.
This method is required by the interface Iterator.
| public boolean valid ( ) | ||
| return | boolean | Whether there is a valid dataset at the current position. |
|---|---|---|