|
|
|
<?php
|
|
|
|
/**
|
|
|
|
* @link http://www.yiiframework.com/
|
|
|
|
* @copyright Copyright (c) 2008 Yii Software LLC
|
|
|
|
* @license http://www.yiiframework.com/license/
|
|
|
|
*/
|
|
|
|
|
|
|
|
namespace yii\elasticsearch;
|
|
|
|
|
|
|
|
use yii\base\InvalidParamException;
|
|
|
|
use yii\base\NotSupportedException;
|
|
|
|
use yii\helpers\Json;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* QueryBuilder builds an elasticsearch query based on the specification given as a [[Query]] object.
|
|
|
|
*
|
|
|
|
* @author Carsten Brandt <mail@cebe.cc>
|
|
|
|
* @since 2.0
|
|
|
|
*/
|
|
|
|
class QueryBuilder extends \yii\base\Object
|
|
|
|
{
|
|
|
|
/**
|
|
|
|
* @var Connection the database connection.
|
|
|
|
*/
|
|
|
|
public $db;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Constructor.
|
|
|
|
* @param Connection $connection the database connection.
|
|
|
|
* @param array $config name-value pairs that will be used to initialize the object properties
|
|
|
|
*/
|
|
|
|
public function __construct($connection, $config = [])
|
|
|
|
{
|
|
|
|
$this->db = $connection;
|
|
|
|
parent::__construct($config);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Generates query from a [[Query]] object.
|
|
|
|
* @param Query $query the [[Query]] object from which the query will be generated
|
|
|
|
* @return array the generated SQL statement (the first array element) and the corresponding
|
|
|
|
* parameters to be bound to the SQL statement (the second array element).
|
|
|
|
*/
|
|
|
|
public function build($query)
|
|
|
|
{
|
|
|
|
$parts = [];
|
|
|
|
|
|
|
|
if ($query->fields === []) {
|
|
|
|
$parts['fields'] = [];
|
|
|
|
} elseif ($query->fields !== null) {
|
|
|
|
$fields = [];
|
|
|
|
$scriptFields = [];
|
|
|
|
foreach($query->fields as $key => $field) {
|
|
|
|
if (is_int($key)) {
|
|
|
|
$fields[] = $field;
|
|
|
|
} else {
|
|
|
|
$scriptFields[$key] = $field;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
if (!empty($fields)) {
|
|
|
|
$parts['fields'] = $fields;
|
|
|
|
}
|
|
|
|
if (!empty($scriptFields)) {
|
|
|
|
$parts['script_fields'] = $scriptFields;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
if ($query->source !== null) {
|
|
|
|
$parts['_source'] = $query->source;
|
|
|
|
}
|
|
|
|
if ($query->limit !== null && $query->limit >= 0) {
|
|
|
|
$parts['size'] = $query->limit;
|
|
|
|
}
|
|
|
|
if ($query->offset > 0) {
|
|
|
|
$parts['from'] = (int) $query->offset;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (empty($query->query)) {
|
|
|
|
$parts['query'] = ["match_all" => (object) []];
|
|
|
|
} else {
|
|
|
|
$parts['query'] = $query->query;
|
|
|
|
}
|
|
|
|
|
|
|
|
$whereFilter = $this->buildCondition($query->where);
|
|
|
|
if (is_string($query->filter)) {
|
|
|
|
if (empty($whereFilter)) {
|
|
|
|
$parts['filter'] = $query->filter;
|
|
|
|
} else {
|
|
|
|
$parts['filter'] = '{"and": [' . $query->filter . ', ' . Json::encode($whereFilter) . ']}';
|
|
|
|
}
|
|
|
|
} elseif ($query->filter !== null) {
|
|
|
|
if (empty($whereFilter)) {
|
|
|
|
$parts['filter'] = $query->filter;
|
|
|
|
} else {
|
|
|
|
$parts['filter'] = ['and' => [$query->filter, $whereFilter]];
|
|
|
|
}
|
|
|
|
} elseif (!empty($whereFilter)) {
|
|
|
|
$parts['filter'] = $whereFilter;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (!empty($query->highlight)) {
|
|
|
|
$parts['highlight'] = $query->highlight;
|
|
|
|
}
|
|
|
|
if (!empty($query->aggregations)) {
|
|
|
|
$parts['aggregations'] = $query->aggregations;
|
|
|
|
}
|
|
|
|
if (!empty($query->stats)) {
|
|
|
|
$parts['stats'] = $query->stats;
|
|
|
|
}
|
|
|
|
if (!empty($query->suggest)) {
|
|
|
|
$parts['suggest'] = $query->suggest;
|
|
|
|
}
|
|
|
|
|
|
|
|
$sort = $this->buildOrderBy($query->orderBy);
|
|
|
|
if (!empty($sort)) {
|
|
|
|
$parts['sort'] = $sort;
|
|
|
|
}
|
|
|
|
|
|
|
|
$options = [];
|
|
|
|
if ($query->timeout !== null) {
|
|
|
|
$options['timeout'] = $query->timeout;
|
|
|
|
}
|
|
|
|
|
|
|
|
return [
|
|
|
|
'queryParts' => $parts,
|
|
|
|
'index' => $query->index,
|
|
|
|
'type' => $query->type,
|
|
|
|
'options' => $options,
|
|
|
|
];
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* adds order by condition to the query
|
|
|
|
*/
|
|
|
|
public function buildOrderBy($columns)
|
|
|
|
{
|
|
|
|
if (empty($columns)) {
|
|
|
|
return [];
|
|
|
|
}
|
|
|
|
$orders = [];
|
|
|
|
foreach ($columns as $name => $direction) {
|
|
|
|
if (is_string($direction)) {
|
|
|
|
$column = $direction;
|
|
|
|
$direction = SORT_ASC;
|
|
|
|
} else {
|
|
|
|
$column = $name;
|
|
|
|
}
|
|
|
|
if ($column == '_id') {
|
|
|
|
$column = '_uid';
|
|
|
|
}
|
|
|
|
|
|
|
|
// allow elasticsearch extended syntax as described in http://www.elasticsearch.org/guide/reference/api/search/sort/
|
|
|
|
if (is_array($direction)) {
|
|
|
|
$orders[] = [$column => $direction];
|
|
|
|
} else {
|
|
|
|
$orders[] = [$column => ($direction === SORT_DESC ? 'desc' : 'asc')];
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return $orders;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Parses the condition specification and generates the corresponding SQL expression.
|
|
|
|
*
|
|
|
|
* @param string|array $condition the condition specification. Please refer to [[Query::where()]] on how to specify a condition.
|
|
|
|
* @throws \yii\base\InvalidParamException if unknown operator is used in query
|
|
|
|
* @throws \yii\base\NotSupportedException if string conditions are used in where
|
|
|
|
* @return string the generated SQL expression
|
|
|
|
*/
|
|
|
|
public function buildCondition($condition)
|
|
|
|
{
|
|
|
|
static $builders = [
|
|
|
|
'not' => 'buildNotCondition',
|
|
|
|
'and' => 'buildAndCondition',
|
|
|
|
'or' => 'buildAndCondition',
|
|
|
|
'between' => 'buildBetweenCondition',
|
|
|
|
'not between' => 'buildBetweenCondition',
|
|
|
|
'in' => 'buildInCondition',
|
|
|
|
'not in' => 'buildInCondition',
|
|
|
|
'like' => 'buildLikeCondition',
|
|
|
|
'not like' => 'buildLikeCondition',
|
|
|
|
'or like' => 'buildLikeCondition',
|
|
|
|
'or not like' => 'buildLikeCondition',
|
|
|
|
];
|
|
|
|
|
|
|
|
if (empty($condition)) {
|
|
|
|
return [];
|
|
|
|
}
|
|
|
|
if (!is_array($condition)) {
|
|
|
|
throw new NotSupportedException('String conditions in where() are not supported by elasticsearch.');
|
|
|
|
}
|
|
|
|
if (isset($condition[0])) { // operator format: operator, operand 1, operand 2, ...
|
|
|
|
$operator = strtolower($condition[0]);
|
|
|
|
if (isset($builders[$operator])) {
|
|
|
|
$method = $builders[$operator];
|
|
|
|
array_shift($condition);
|
|
|
|
|
|
|
|
return $this->$method($operator, $condition);
|
|
|
|
} else {
|
|
|
|
throw new InvalidParamException('Found unknown operator in query: ' . $operator);
|
|
|
|
}
|
|
|
|
} else { // hash format: 'column1' => 'value1', 'column2' => 'value2', ...
|
|
|
|
|
|
|
|
return $this->buildHashCondition($condition);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
private function buildHashCondition($condition)
|
|
|
|
{
|
|
|
|
$parts = [];
|
|
|
|
foreach ($condition as $attribute => $value) {
|
|
|
|
if ($attribute == '_id') {
|
|
|
|
if ($value === null) { // there is no null pk
|
|
|
|
$parts[] = ['terms' => ['_uid' => []]]; // this condition is equal to WHERE false
|
|
|
|
} else {
|
|
|
|
$parts[] = ['ids' => ['values' => is_array($value) ? $value : [$value]]];
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
if (is_array($value)) { // IN condition
|
|
|
|
$parts[] = ['in' => [$attribute => $value]];
|
|
|
|
} else {
|
|
|
|
if ($value === null) {
|
|
|
|
$parts[] = ['missing' => ['field' => $attribute, 'existence' => true, 'null_value' => true]];
|
|
|
|
} else {
|
|
|
|
$parts[] = ['term' => [$attribute => $value]];
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return count($parts) === 1 ? $parts[0] : ['and' => $parts];
|
|
|
|
}
|
|
|
|
|
|
|
|
private function buildNotCondition($operator, $operands)
|
|
|
|
{
|
|
|
|
if (count($operands) != 1) {
|
|
|
|
throw new InvalidParamException("Operator '$operator' requires exactly one operand.");
|
|
|
|
}
|
|
|
|
|
|
|
|
$operand = reset($operands);
|
|
|
|
if (is_array($operand)) {
|
|
|
|
$operand = $this->buildCondition($operand);
|
|
|
|
}
|
|
|
|
|
|
|
|
return [$operator => $operand];
|
|
|
|
}
|
|
|
|
|
|
|
|
private function buildAndCondition($operator, $operands)
|
|
|
|
{
|
|
|
|
$parts = [];
|
|
|
|
foreach ($operands as $operand) {
|
|
|
|
if (is_array($operand)) {
|
|
|
|
$operand = $this->buildCondition($operand);
|
|
|
|
}
|
|
|
|
if (!empty($operand)) {
|
|
|
|
$parts[] = $operand;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
if (!empty($parts)) {
|
|
|
|
return [$operator => $parts];
|
|
|
|
} else {
|
|
|
|
return [];
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
private function buildBetweenCondition($operator, $operands)
|
|
|
|
{
|
|
|
|
if (!isset($operands[0], $operands[1], $operands[2])) {
|
|
|
|
throw new InvalidParamException("Operator '$operator' requires three operands.");
|
|
|
|
}
|
|
|
|
|
|
|
|
list($column, $value1, $value2) = $operands;
|
|
|
|
if ($column == '_id') {
|
|
|
|
throw new NotSupportedException('Between condition is not supported for the _id field.');
|
|
|
|
}
|
|
|
|
$filter = ['range' => [$column => ['gte' => $value1, 'lte' => $value2]]];
|
|
|
|
if ($operator == 'not between') {
|
|
|
|
$filter = ['not' => $filter];
|
|
|
|
}
|
|
|
|
|
|
|
|
return $filter;
|
|
|
|
}
|
|
|
|
|
|
|
|
private function buildInCondition($operator, $operands)
|
|
|
|
{
|
|
|
|
if (!isset($operands[0], $operands[1])) {
|
|
|
|
throw new InvalidParamException("Operator '$operator' requires two operands.");
|
|
|
|
}
|
|
|
|
|
|
|
|
list($column, $values) = $operands;
|
|
|
|
|
|
|
|
$values = (array) $values;
|
|
|
|
|
|
|
|
if (empty($values) || $column === []) {
|
|
|
|
return $operator === 'in' ? ['terms' => ['_uid' => []]] : []; // this condition is equal to WHERE false
|
|
|
|
}
|
|
|
|
|
|
|
|
if (count($column) > 1) {
|
|
|
|
return $this->buildCompositeInCondition($operator, $column, $values);
|
|
|
|
} elseif (is_array($column)) {
|
|
|
|
$column = reset($column);
|
|
|
|
}
|
|
|
|
$canBeNull = false;
|
|
|
|
foreach ($values as $i => $value) {
|
|
|
|
if (is_array($value)) {
|
|
|
|
$values[$i] = $value = isset($value[$column]) ? $value[$column] : null;
|
|
|
|
}
|
|
|
|
if ($value === null) {
|
|
|
|
$canBeNull = true;
|
|
|
|
unset($values[$i]);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
if ($column == '_id') {
|
|
|
|
if (empty($values) && $canBeNull) { // there is no null pk
|
|
|
|
$filter = ['terms' => ['_uid' => []]]; // this condition is equal to WHERE false
|
|
|
|
} else {
|
|
|
|
$filter = ['ids' => ['values' => array_values($values)]];
|
|
|
|
if ($canBeNull) {
|
|
|
|
$filter = ['or' => [$filter, ['missing' => ['field' => $column, 'existence' => true, 'null_value' => true]]]];
|
|
|
|
}
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
if (empty($values) && $canBeNull) {
|
|
|
|
$filter = ['missing' => ['field' => $column, 'existence' => true, 'null_value' => true]];
|
|
|
|
} else {
|
|
|
|
$filter = ['in' => [$column => array_values($values)]];
|
|
|
|
if ($canBeNull) {
|
|
|
|
$filter = ['or' => [$filter, ['missing' => ['field' => $column, 'existence' => true, 'null_value' => true]]]];
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
if ($operator == 'not in') {
|
|
|
|
$filter = ['not' => $filter];
|
|
|
|
}
|
|
|
|
|
|
|
|
return $filter;
|
|
|
|
}
|
|
|
|
|
|
|
|
protected function buildCompositeInCondition($operator, $columns, $values)
|
|
|
|
{
|
|
|
|
throw new NotSupportedException('composite in is not supported by elasticsearch.');
|
|
|
|
}
|
|
|
|
|
|
|
|
private function buildLikeCondition($operator, $operands)
|
|
|
|
{
|
|
|
|
throw new NotSupportedException('like conditions are not supported by elasticsearch.');
|
|
|
|
}
|
|
|
|
}
|