Class yii\elasticsearch\BatchQueryResult

Inheritanceyii\elasticsearch\BatchQueryResult » yii\base\BaseObject
ImplementsIterator
Available since version2.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

Hide inherited properties

PropertyTypeDescriptionDefined 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

Hide inherited methods

MethodDescriptionDefined 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

Hide inherited methods

MethodDescriptionDefined By
fetchData() Fetches the next batch of data. yii\elasticsearch\BatchQueryResult

Property Details

$db public property

The DB connection to be used when performing batch query. If null, the elasticsearch application component will be used.

$each public property

Whether to return a single row during each iteration. If false, a whole batch of rows will be returned in each iteration.

public boolean $each false
$query public property

The query object associated with this batch query. Do not modify this property directly unless after reset() is called explicitly.

$scrollWindow public property

The amount of time to keep the scroll window open (in ElasticSearch time units.

public string $scrollWindow '1m'

Method Details

__destruct() public method

Destructor.

public void __destruct ( )
current() public method

Returns the current dataset.

This method is required by the interface Iterator.

public mixed current ( )
return mixed

The current dataset.

fetchData() protected method

Fetches the next batch of data.

protected array fetchData ( )
return array

The data fetched

key() public method

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.

next() public method

Moves the internal pointer to the next dataset.

This method is required by the interface Iterator.

public void next ( )
reset() public method

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 ( )
rewind() public method

Resets the iterator to the initial state.

This method is required by the interface Iterator.

public void rewind ( )
valid() public method

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.