575 lines
15 KiB
PHP
575 lines
15 KiB
PHP
![]() |
<?php
|
||
|
|
||
|
namespace Illuminate\Database\Query\Grammars;
|
||
|
|
||
|
use Illuminate\Database\Query\Builder;
|
||
|
use Illuminate\Database\Query\JoinLateralClause;
|
||
|
use Illuminate\Support\Arr;
|
||
|
use Illuminate\Support\Str;
|
||
|
|
||
|
class SqlServerGrammar extends Grammar
|
||
|
{
|
||
|
/**
|
||
|
* All of the available clause operators.
|
||
|
*
|
||
|
* @var string[]
|
||
|
*/
|
||
|
protected $operators = [
|
||
|
'=', '<', '>', '<=', '>=', '!<', '!>', '<>', '!=',
|
||
|
'like', 'not like', 'ilike',
|
||
|
'&', '&=', '|', '|=', '^', '^=',
|
||
|
];
|
||
|
|
||
|
/**
|
||
|
* The components that make up a select clause.
|
||
|
*
|
||
|
* @var string[]
|
||
|
*/
|
||
|
protected $selectComponents = [
|
||
|
'aggregate',
|
||
|
'columns',
|
||
|
'from',
|
||
|
'indexHint',
|
||
|
'joins',
|
||
|
'wheres',
|
||
|
'groups',
|
||
|
'havings',
|
||
|
'orders',
|
||
|
'offset',
|
||
|
'limit',
|
||
|
'lock',
|
||
|
];
|
||
|
|
||
|
/**
|
||
|
* Compile a select query into SQL.
|
||
|
*
|
||
|
* @param \Illuminate\Database\Query\Builder $query
|
||
|
* @return string
|
||
|
*/
|
||
|
public function compileSelect(Builder $query)
|
||
|
{
|
||
|
// An order by clause is required for SQL Server offset to function...
|
||
|
if ($query->offset && empty($query->orders)) {
|
||
|
$query->orders[] = ['sql' => '(SELECT 0)'];
|
||
|
}
|
||
|
|
||
|
return parent::compileSelect($query);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Compile the "select *" portion of the query.
|
||
|
*
|
||
|
* @param \Illuminate\Database\Query\Builder $query
|
||
|
* @param array $columns
|
||
|
* @return string|null
|
||
|
*/
|
||
|
protected function compileColumns(Builder $query, $columns)
|
||
|
{
|
||
|
if (! is_null($query->aggregate)) {
|
||
|
return;
|
||
|
}
|
||
|
|
||
|
$select = $query->distinct ? 'select distinct ' : 'select ';
|
||
|
|
||
|
// If there is a limit on the query, but not an offset, we will add the top
|
||
|
// clause to the query, which serves as a "limit" type clause within the
|
||
|
// SQL Server system similar to the limit keywords available in MySQL.
|
||
|
if (is_numeric($query->limit) && $query->limit > 0 && $query->offset <= 0) {
|
||
|
$select .= 'top '.((int) $query->limit).' ';
|
||
|
}
|
||
|
|
||
|
return $select.$this->columnize($columns);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Compile the "from" portion of the query.
|
||
|
*
|
||
|
* @param \Illuminate\Database\Query\Builder $query
|
||
|
* @param string $table
|
||
|
* @return string
|
||
|
*/
|
||
|
protected function compileFrom(Builder $query, $table)
|
||
|
{
|
||
|
$from = parent::compileFrom($query, $table);
|
||
|
|
||
|
if (is_string($query->lock)) {
|
||
|
return $from.' '.$query->lock;
|
||
|
}
|
||
|
|
||
|
if (! is_null($query->lock)) {
|
||
|
return $from.' with(rowlock,'.($query->lock ? 'updlock,' : '').'holdlock)';
|
||
|
}
|
||
|
|
||
|
return $from;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Compile the index hints for the query.
|
||
|
*
|
||
|
* @param \Illuminate\Database\Query\Builder $query
|
||
|
* @param \Illuminate\Database\Query\IndexHint $indexHint
|
||
|
* @return string
|
||
|
*/
|
||
|
protected function compileIndexHint(Builder $query, $indexHint)
|
||
|
{
|
||
|
return $indexHint->type === 'force'
|
||
|
? "with (index({$indexHint->index}))"
|
||
|
: '';
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* {@inheritdoc}
|
||
|
*
|
||
|
* @param \Illuminate\Database\Query\Builder $query
|
||
|
* @param array $where
|
||
|
* @return string
|
||
|
*/
|
||
|
protected function whereBitwise(Builder $query, $where)
|
||
|
{
|
||
|
$value = $this->parameter($where['value']);
|
||
|
|
||
|
$operator = str_replace('?', '??', $where['operator']);
|
||
|
|
||
|
return '('.$this->wrap($where['column']).' '.$operator.' '.$value.') != 0';
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Compile a "where date" clause.
|
||
|
*
|
||
|
* @param \Illuminate\Database\Query\Builder $query
|
||
|
* @param array $where
|
||
|
* @return string
|
||
|
*/
|
||
|
protected function whereDate(Builder $query, $where)
|
||
|
{
|
||
|
$value = $this->parameter($where['value']);
|
||
|
|
||
|
return 'cast('.$this->wrap($where['column']).' as date) '.$where['operator'].' '.$value;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Compile a "where time" clause.
|
||
|
*
|
||
|
* @param \Illuminate\Database\Query\Builder $query
|
||
|
* @param array $where
|
||
|
* @return string
|
||
|
*/
|
||
|
protected function whereTime(Builder $query, $where)
|
||
|
{
|
||
|
$value = $this->parameter($where['value']);
|
||
|
|
||
|
return 'cast('.$this->wrap($where['column']).' as time) '.$where['operator'].' '.$value;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Compile a "JSON contains" statement into SQL.
|
||
|
*
|
||
|
* @param string $column
|
||
|
* @param string $value
|
||
|
* @return string
|
||
|
*/
|
||
|
protected function compileJsonContains($column, $value)
|
||
|
{
|
||
|
[$field, $path] = $this->wrapJsonFieldAndPath($column);
|
||
|
|
||
|
return $value.' in (select [value] from openjson('.$field.$path.'))';
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Prepare the binding for a "JSON contains" statement.
|
||
|
*
|
||
|
* @param mixed $binding
|
||
|
* @return string
|
||
|
*/
|
||
|
public function prepareBindingForJsonContains($binding)
|
||
|
{
|
||
|
return is_bool($binding) ? json_encode($binding) : $binding;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Compile a "JSON contains key" statement into SQL.
|
||
|
*
|
||
|
* @param string $column
|
||
|
* @return string
|
||
|
*/
|
||
|
protected function compileJsonContainsKey($column)
|
||
|
{
|
||
|
$segments = explode('->', $column);
|
||
|
|
||
|
$lastSegment = array_pop($segments);
|
||
|
|
||
|
if (preg_match('/\[([0-9]+)\]$/', $lastSegment, $matches)) {
|
||
|
$segments[] = Str::beforeLast($lastSegment, $matches[0]);
|
||
|
|
||
|
$key = $matches[1];
|
||
|
} else {
|
||
|
$key = "'".str_replace("'", "''", $lastSegment)."'";
|
||
|
}
|
||
|
|
||
|
[$field, $path] = $this->wrapJsonFieldAndPath(implode('->', $segments));
|
||
|
|
||
|
return $key.' in (select [key] from openjson('.$field.$path.'))';
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Compile a "JSON length" statement into SQL.
|
||
|
*
|
||
|
* @param string $column
|
||
|
* @param string $operator
|
||
|
* @param string $value
|
||
|
* @return string
|
||
|
*/
|
||
|
protected function compileJsonLength($column, $operator, $value)
|
||
|
{
|
||
|
[$field, $path] = $this->wrapJsonFieldAndPath($column);
|
||
|
|
||
|
return '(select count(*) from openjson('.$field.$path.')) '.$operator.' '.$value;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Compile a "JSON value cast" statement into SQL.
|
||
|
*
|
||
|
* @param string $value
|
||
|
* @return string
|
||
|
*/
|
||
|
public function compileJsonValueCast($value)
|
||
|
{
|
||
|
return 'json_query('.$value.')';
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Compile a single having clause.
|
||
|
*
|
||
|
* @param array $having
|
||
|
* @return string
|
||
|
*/
|
||
|
protected function compileHaving(array $having)
|
||
|
{
|
||
|
if ($having['type'] === 'Bitwise') {
|
||
|
return $this->compileHavingBitwise($having);
|
||
|
}
|
||
|
|
||
|
return parent::compileHaving($having);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Compile a having clause involving a bitwise operator.
|
||
|
*
|
||
|
* @param array $having
|
||
|
* @return string
|
||
|
*/
|
||
|
protected function compileHavingBitwise($having)
|
||
|
{
|
||
|
$column = $this->wrap($having['column']);
|
||
|
|
||
|
$parameter = $this->parameter($having['value']);
|
||
|
|
||
|
return '('.$column.' '.$having['operator'].' '.$parameter.') != 0';
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Compile a delete statement without joins into SQL.
|
||
|
*
|
||
|
* @param \Illuminate\Database\Query\Builder $query
|
||
|
* @param string $table
|
||
|
* @param string $where
|
||
|
* @return string
|
||
|
*/
|
||
|
protected function compileDeleteWithoutJoins(Builder $query, $table, $where)
|
||
|
{
|
||
|
$sql = parent::compileDeleteWithoutJoins($query, $table, $where);
|
||
|
|
||
|
return ! is_null($query->limit) && $query->limit > 0 && $query->offset <= 0
|
||
|
? Str::replaceFirst('delete', 'delete top ('.$query->limit.')', $sql)
|
||
|
: $sql;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Compile the random statement into SQL.
|
||
|
*
|
||
|
* @param string|int $seed
|
||
|
* @return string
|
||
|
*/
|
||
|
public function compileRandom($seed)
|
||
|
{
|
||
|
return 'NEWID()';
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Compile the "limit" portions of the query.
|
||
|
*
|
||
|
* @param \Illuminate\Database\Query\Builder $query
|
||
|
* @param int $limit
|
||
|
* @return string
|
||
|
*/
|
||
|
protected function compileLimit(Builder $query, $limit)
|
||
|
{
|
||
|
$limit = (int) $limit;
|
||
|
|
||
|
if ($limit && $query->offset > 0) {
|
||
|
return "fetch next {$limit} rows only";
|
||
|
}
|
||
|
|
||
|
return '';
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Compile a row number clause.
|
||
|
*
|
||
|
* @param string $partition
|
||
|
* @param string $orders
|
||
|
* @return string
|
||
|
*/
|
||
|
protected function compileRowNumber($partition, $orders)
|
||
|
{
|
||
|
if (empty($orders)) {
|
||
|
$orders = 'order by (select 0)';
|
||
|
}
|
||
|
|
||
|
return parent::compileRowNumber($partition, $orders);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Compile the "offset" portions of the query.
|
||
|
*
|
||
|
* @param \Illuminate\Database\Query\Builder $query
|
||
|
* @param int $offset
|
||
|
* @return string
|
||
|
*/
|
||
|
protected function compileOffset(Builder $query, $offset)
|
||
|
{
|
||
|
$offset = (int) $offset;
|
||
|
|
||
|
if ($offset) {
|
||
|
return "offset {$offset} rows";
|
||
|
}
|
||
|
|
||
|
return '';
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Compile the lock into SQL.
|
||
|
*
|
||
|
* @param \Illuminate\Database\Query\Builder $query
|
||
|
* @param bool|string $value
|
||
|
* @return string
|
||
|
*/
|
||
|
protected function compileLock(Builder $query, $value)
|
||
|
{
|
||
|
return '';
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Wrap a union subquery in parentheses.
|
||
|
*
|
||
|
* @param string $sql
|
||
|
* @return string
|
||
|
*/
|
||
|
protected function wrapUnion($sql)
|
||
|
{
|
||
|
return 'select * from ('.$sql.') as '.$this->wrapTable('temp_table');
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Compile an exists statement into SQL.
|
||
|
*
|
||
|
* @param \Illuminate\Database\Query\Builder $query
|
||
|
* @return string
|
||
|
*/
|
||
|
public function compileExists(Builder $query)
|
||
|
{
|
||
|
$existsQuery = clone $query;
|
||
|
|
||
|
$existsQuery->columns = [];
|
||
|
|
||
|
return $this->compileSelect($existsQuery->selectRaw('1 [exists]')->limit(1));
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Compile an update statement with joins into SQL.
|
||
|
*
|
||
|
* @param \Illuminate\Database\Query\Builder $query
|
||
|
* @param string $table
|
||
|
* @param string $columns
|
||
|
* @param string $where
|
||
|
* @return string
|
||
|
*/
|
||
|
protected function compileUpdateWithJoins(Builder $query, $table, $columns, $where)
|
||
|
{
|
||
|
$alias = last(explode(' as ', $table));
|
||
|
|
||
|
$joins = $this->compileJoins($query, $query->joins);
|
||
|
|
||
|
return "update {$alias} set {$columns} from {$table} {$joins} {$where}";
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Compile an "upsert" statement into SQL.
|
||
|
*
|
||
|
* @param \Illuminate\Database\Query\Builder $query
|
||
|
* @param array $values
|
||
|
* @param array $uniqueBy
|
||
|
* @param array $update
|
||
|
* @return string
|
||
|
*/
|
||
|
public function compileUpsert(Builder $query, array $values, array $uniqueBy, array $update)
|
||
|
{
|
||
|
$columns = $this->columnize(array_keys(reset($values)));
|
||
|
|
||
|
$sql = 'merge '.$this->wrapTable($query->from).' ';
|
||
|
|
||
|
$parameters = collect($values)->map(function ($record) {
|
||
|
return '('.$this->parameterize($record).')';
|
||
|
})->implode(', ');
|
||
|
|
||
|
$sql .= 'using (values '.$parameters.') '.$this->wrapTable('laravel_source').' ('.$columns.') ';
|
||
|
|
||
|
$on = collect($uniqueBy)->map(function ($column) use ($query) {
|
||
|
return $this->wrap('laravel_source.'.$column).' = '.$this->wrap($query->from.'.'.$column);
|
||
|
})->implode(' and ');
|
||
|
|
||
|
$sql .= 'on '.$on.' ';
|
||
|
|
||
|
if ($update) {
|
||
|
$update = collect($update)->map(function ($value, $key) {
|
||
|
return is_numeric($key)
|
||
|
? $this->wrap($value).' = '.$this->wrap('laravel_source.'.$value)
|
||
|
: $this->wrap($key).' = '.$this->parameter($value);
|
||
|
})->implode(', ');
|
||
|
|
||
|
$sql .= 'when matched then update set '.$update.' ';
|
||
|
}
|
||
|
|
||
|
$sql .= 'when not matched then insert ('.$columns.') values ('.$columns.');';
|
||
|
|
||
|
return $sql;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Prepare the bindings for an update statement.
|
||
|
*
|
||
|
* @param array $bindings
|
||
|
* @param array $values
|
||
|
* @return array
|
||
|
*/
|
||
|
public function prepareBindingsForUpdate(array $bindings, array $values)
|
||
|
{
|
||
|
$cleanBindings = Arr::except($bindings, 'select');
|
||
|
|
||
|
return array_values(
|
||
|
array_merge($values, Arr::flatten($cleanBindings))
|
||
|
);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Compile a "lateral join" clause.
|
||
|
*
|
||
|
* @param \Illuminate\Database\Query\JoinLateralClause $join
|
||
|
* @param string $expression
|
||
|
* @return string
|
||
|
*/
|
||
|
public function compileJoinLateral(JoinLateralClause $join, string $expression): string
|
||
|
{
|
||
|
$type = $join->type == 'left' ? 'outer' : 'cross';
|
||
|
|
||
|
return trim("{$type} apply {$expression}");
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Compile the SQL statement to define a savepoint.
|
||
|
*
|
||
|
* @param string $name
|
||
|
* @return string
|
||
|
*/
|
||
|
public function compileSavepoint($name)
|
||
|
{
|
||
|
return 'SAVE TRANSACTION '.$name;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Compile the SQL statement to execute a savepoint rollback.
|
||
|
*
|
||
|
* @param string $name
|
||
|
* @return string
|
||
|
*/
|
||
|
public function compileSavepointRollBack($name)
|
||
|
{
|
||
|
return 'ROLLBACK TRANSACTION '.$name;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Get the format for database stored dates.
|
||
|
*
|
||
|
* @return string
|
||
|
*/
|
||
|
public function getDateFormat()
|
||
|
{
|
||
|
return 'Y-m-d H:i:s.v';
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Wrap a single string in keyword identifiers.
|
||
|
*
|
||
|
* @param string $value
|
||
|
* @return string
|
||
|
*/
|
||
|
protected function wrapValue($value)
|
||
|
{
|
||
|
return $value === '*' ? $value : '['.str_replace(']', ']]', $value).']';
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Wrap the given JSON selector.
|
||
|
*
|
||
|
* @param string $value
|
||
|
* @return string
|
||
|
*/
|
||
|
protected function wrapJsonSelector($value)
|
||
|
{
|
||
|
[$field, $path] = $this->wrapJsonFieldAndPath($value);
|
||
|
|
||
|
return 'json_value('.$field.$path.')';
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Wrap the given JSON boolean value.
|
||
|
*
|
||
|
* @param string $value
|
||
|
* @return string
|
||
|
*/
|
||
|
protected function wrapJsonBooleanValue($value)
|
||
|
{
|
||
|
return "'".$value."'";
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Wrap a table in keyword identifiers.
|
||
|
*
|
||
|
* @param \Illuminate\Contracts\Database\Query\Expression|string $table
|
||
|
* @return string
|
||
|
*/
|
||
|
public function wrapTable($table)
|
||
|
{
|
||
|
if (! $this->isExpression($table)) {
|
||
|
return $this->wrapTableValuedFunction(parent::wrapTable($table));
|
||
|
}
|
||
|
|
||
|
return $this->getValue($table);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Wrap a table in keyword identifiers.
|
||
|
*
|
||
|
* @param string $table
|
||
|
* @return string
|
||
|
*/
|
||
|
protected function wrapTableValuedFunction($table)
|
||
|
{
|
||
|
if (preg_match('/^(.+?)(\(.*?\))]$/', $table, $matches) === 1) {
|
||
|
$table = $matches[1].']'.$matches[2];
|
||
|
}
|
||
|
|
||
|
return $table;
|
||
|
}
|
||
|
}
|