Граф наследования:SqlHelper:

Открытые члены
	__construct (Connection $connection)

	getLeftQuote ()

	getRightQuote ()

	getAliasLength ()

	quote ($identifier)

	getQueryDelimiter ()

	forSql ($value, $maxLength=0)

	getCurrentDateTimeFunction ()

	getCurrentDateFunction ()

	addSecondsToDateTime ($seconds, $from=null)

	addDaysToDateTime ($days, $from=null)

	getDatetimeToDateFunction ($value)

	formatDate ($format, $field=null)

	getSubstrFunction ($str, $from, $length=null)

	getConcatFunction ()

	getIsNullFunction ($expression, $result)

	getLengthFunction ($field)

	getCharToDateFunction ($value)

	getDateToCharFunction ($fieldName)

	castToChar ($fieldName)

	softCastTextToChar ($fieldName)

	getTopSql ($sql, $limit, $offset=0)

	prepareInsert ($tableName, array $fields, $returnAsArray=false)

	prepareUpdate ($tableName, array $fields)

	prepareMerge ($tableName, array $primaryFields, array $insertFields, array $updateFields)

	prepareAssignment ($tableName, $columnName, $value)

	convertToDb ($value, ORM\Fields\IReadable $field=null)

	convertFromDb ($value, ORM\Fields\IReadable $field)

	convertToDbInteger ($value)

	convertFromDbInteger ($value)

	convertToDbFloat ($value, $scale=null)

	convertFromDbFloat ($value, $scale=null)

	convertToDbString ($value, $length=null)

	convertFromDbString ($value, $length=null)

	convertToDbText ($value)

	convertFromDbText ($value)

	convertToDbDate ($value)

	convertFromDbDate ($value)

	convertToDbDateTime ($value)

	convertFromDbDateTime ($value)

	convertDatetimeField ($value)

	convertDateField ($value)

	getConverter (ORM\Fields\ScalarField $field)

	getColumnTypeByField (ORM\Fields\ScalarField $field)

	getFieldByColumnType ($name, $type, array $parameters=null)

	getAscendingOrder ()

	getDescendingOrder ()

	getConditionalAssignment (string $field, string $value)

	getInsertIgnore ($tableName, $fields, $sql)

	getRandomFunction ()

	getSha1Function ($field)

	getRegexpOperator ($field, $regexp)

	values ($identifier)

	getMatchFunction ($field, $value)

	getMatchAndExpression ($values, $prefixSearch=false)

	getMatchOrExpression ($values, $prefixSearch=false)

	prepareMergeMultiple ($tableName, array $primaryFields, array $insertRows)

	prepareMergeSelect ($tableName, array $primaryFields, array $selectFields, $select, $updateFields)

	prepareDeleteLimit ($tableName, array $primaryFields, $where, array $order, $limit)

	initRowNumber ($variableName)

	getRowNumber ($variableName)

	prepareCorrelatedUpdate ($tableName, $tableAlias, $fields, $from, $where)

	prepareMergeValues (string $tableName, array $primaryFields, array $insertRows, array $updateFields=[])

	getOrderByStringField (string $field, array $values, bool $quote=true)

	getOrderByIntField (string $field, array $values, bool $quote=true)

Защищенные члены
	prepareBinds (array $tableFields, array $fields)

	getOrderByField (string $field, array $values, callable $callback, bool $quote=true)

Защищенные данные
	$connection

	$idCache

Подробное описание

См. определение в файле sqlhelper.php строка 9

Конструктор(ы)

◆ __construct()

__construct ( Connection $connection )

Аргументы

Connection $connection Database connection.

См. определение в файле sqlhelper.php строка 19

Методы

◆ addDaysToDateTime()

addDaysToDateTime	(		$days,
			$from = null )

Returns function for adding days time interval to $from.

If $from is null or omitted, then current time is used.

$days and $from parameters are SQL unsafe.

@abstract

Аргументы

integer	$days	How many days to add.
integer	$from	Datetime database field of expression.

Возвращает: string

Переопределяется в MysqliSqlHelper и PgsqlSqlHelper.

См. определение в файле sqlhelper.php строка 143

◆ addSecondsToDateTime()

addSecondsToDateTime	(		$seconds,
			$from = null )

abstract

Returns function for adding seconds time interval to $from.

If $from is null or omitted, then current time is used.

$seconds and $from parameters are SQL unsafe.

Аргументы

integer	$seconds	How many seconds to add.
integer	$from	Datetime database field of expression.

Возвращает: string

Переопределяется в MssqlSqlHelper, MysqlCommonSqlHelper, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ castToChar()

castToChar ( $fieldName )

abstract

Returns CAST expression for converting field or expression into string

Аргументы

string $fieldName

Возвращает: string

Переопределяется в MssqlSqlHelper, MysqlCommonSqlHelper, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ convertDateField()

convertDateField ( $value )

Helper function.

Аргументы

string $value Value fetched.

Возвращает: null|\Bitrix\Main\Type\Date

См. также: SqlHelper::getConverter

Переопределяется в MysqlCommonSqlHelper.

См. определение в файле sqlhelper.php строка 692

◆ convertDatetimeField()

convertDatetimeField ( $value )

Helper function.

Аргументы

string $value Value fetched.

Возвращает: null|\Bitrix\Main\Type\DateTime

См. также: SqlHelper::getConverter

Переопределяется в MysqlCommonSqlHelper.

См. определение в файле sqlhelper.php строка 676

◆ convertFromDb()

convertFromDb	(		$value,
		ORM\Fields\IReadable	$field )

Returns $value converted to a type according to $field type.

For example if $field is Entity\DatetimeField then returned value will be the instance of Type\DateTime.

Аргументы

mixed	$value	Value to be converted.
ORM\Fields\IReadable	$field	Type "source".

Возвращает: mixed

См. определение в файле sqlhelper.php строка 480

◆ convertFromDbDate()

convertFromDbDate ( $value )

Аргументы

$value

Возвращает: Type\Date

Исключения

Main

ObjectException

Переопределяется в MssqlSqlHelper, MysqlCommonSqlHelper, MysqliSqlHelper и PgsqlSqlHelper.

См. определение в файле sqlhelper.php строка 620

◆ convertFromDbDateTime()

convertFromDbDateTime ( $value )

Аргументы

$value

Возвращает: Type\DateTime

Исключения

Main

ObjectException

Переопределяется в MssqlSqlHelper, MysqlCommonSqlHelper, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

См. определение в файле sqlhelper.php строка 660

◆ convertFromDbFloat()

convertFromDbFloat	(		$value,
			$scale = null )

Аргументы

	$value
int	$scale

Возвращает: float

См. определение в файле sqlhelper.php строка 532

◆ convertFromDbInteger()

convertFromDbInteger ( $value )

Аргументы

$value

Возвращает: int

См. определение в файле sqlhelper.php строка 502

◆ convertFromDbString()

convertFromDbString	(		$value,
			$length = null )

Аргументы

string	$value
int	$length

Возвращает: string

Переопределяется в MssqlSqlHelper и OracleSqlHelper.

См. определение в файле sqlhelper.php строка 558

◆ convertFromDbText()

convertFromDbText ( $value )

Аргументы

$value

Возвращает: string

См. определение в файле sqlhelper.php строка 585

◆ convertToDb()

convertToDb	(		$value,
		ORM\Fields\IReadable	$field = null )

Converts values to the string according to the column type to use it in a SQL query.

Аргументы

mixed	$value	Value to be converted.
ORM\Fields\IReadable \| null	$field	Type "source".

Возвращает: string Value to write to column.

См. определение в файле sqlhelper.php строка 437

◆ convertToDbDate()

convertToDbDate ( $value )

Converts value to the string according to the data type to use it in a SQL query.

Аргументы

mixed $value Value to be converted.

Возвращает: string Value to write to column.

Исключения

Main

ArgumentTypeException

См. определение в файле sqlhelper.php строка 598

◆ convertToDbDateTime()

convertToDbDateTime ( $value )

Converts value to the string according to the data type to use it in a SQL query.

Аргументы

mixed $value Value to be converted.

Возвращает: string Value to write to column.

Исключения

Main

ArgumentTypeException

См. определение в файле sqlhelper.php строка 633

◆ convertToDbFloat()

convertToDbFloat	(		$value,
			$scale = null )

Converts value to the string according to the data type to use it in a SQL query.

Аргументы

mixed	$value	Value to be converted.
int \| null	$scale	Precise to round float value.

Возвращает: string Value to write to column.

См. определение в файле sqlhelper.php строка 515

◆ convertToDbInteger()

convertToDbInteger ( $value )

Converts value to the string according to the data type to use it in a SQL query.

Аргументы

mixed $value Value to be converted.

Возвращает: int Value to write to column.

См. определение в файле sqlhelper.php строка 492

◆ convertToDbString()

convertToDbString	(		$value,
			$length = null )

Converts value to the string according to the data type to use it in a SQL query.

Аргументы

mixed	$value	Value to be converted.
int \| null	$length	Maximum acceptable length of the value

Возвращает: string Value to write to column.

См. определение в файле sqlhelper.php строка 547

◆ convertToDbText()

convertToDbText ( $value )

Converts value to the string according to the data type to use it in a SQL query.

Аргументы

mixed $value Value to be converted.

Возвращает: string Value to write to column.

Переопределяется в OracleSqlHelper.

См. определение в файле sqlhelper.php строка 575

◆ formatDate()

formatDate	(		$format,
			$field = null )

abstract

Returns database expression for converting $field value according the $format.

Following format parts converted:

YYYY A full numeric representation of a year, 4 digits
MMMM A full textual representation of a month, such as January or March
MM Numeric representation of a month, with leading zeros
MI Minutes with leading zeros
M A short textual representation of a month, three letters
DD Day of the month, 2 digits with leading zeros
HH 24-hour format of an hour with leading zeros
H 24-hour format of an hour without leading zeros
GG 12-hour format of an hour with leading zeros
G 12-hour format of an hour without leading zeros
SS Seconds with leading zeros
TT AM or PM
T AM or PM
W Day of the week (0=Sunday ... 6=Saturday)

$field parameter is SQL unsafe.

Аргументы

string	$format	Format string.
string	$field	Database field or expression.

Возвращает: string

Переопределяется в MssqlSqlHelper, MysqlCommonSqlHelper, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ forSql()

forSql	(		$value,
			$maxLength = 0 )

abstract

Escapes special characters in a string for use in an SQL statement.

Аргументы

string	$value	Value to be escaped.
integer	$maxLength	Limits string length if set.

Возвращает: string

Переопределяется в MssqlSqlHelper, MysqliSqlHelper, MysqlSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ getAliasLength()

getAliasLength ( )

abstract

Returns maximum length of an alias in a select statement

Возвращает: integer

Переопределяется в MssqlSqlHelper, MysqlCommonSqlHelper, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ getAscendingOrder()

getAscendingOrder ( )

Returns ascending order specifier for ORDER BY clause.

Возвращает: string

Переопределяется в OracleSqlHelper и PgsqlSqlHelper.

См. определение в файле sqlhelper.php строка 736

◆ getCharToDateFunction()

getCharToDateFunction ( $value )

abstract

Returns function for converting string value into datetime. $value must be in YYYY-MM-DD HH:MI:SS format.

$value parameter is SQL unsafe.

Аргументы

string $value String in YYYY-MM-DD HH:MI:SS format.

Возвращает: string

См. также: SqlHelper::formatDate

Переопределяется в MssqlSqlHelper, MysqlCommonSqlHelper, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ getColumnTypeByField()

getColumnTypeByField ( ORM\Fields\ScalarField $field )

abstract

Returns a column type according to ScalarField object.

Аргументы

\Bitrix\Main\ORM\Fields\ScalarField $field Type "source".

Возвращает: string

◆ getConcatFunction()

getConcatFunction ( )

abstract

Returns function for concatenating database fields or expressions.

All parameters are SQL unsafe.

Аргументы

string $field,... Database fields or expressions.

Возвращает: string

Переопределяется в MssqlSqlHelper, MysqlCommonSqlHelper, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ getConditionalAssignment()

getConditionalAssignment	(	string	$field,
		string	$value )

Аргументы

string	$field
string	$value

Возвращает: string

Переопределяется в MysqlCommonSqlHelper.

См. определение в файле sqlhelper.php строка 756

◆ getConverter()

getConverter ( ORM\Fields\ScalarField $field )

Returns callback to be called for a field value on fetch. Used for soft conversion. For strict results

См. также: ORM\Query\Result::setStrictValueConverters()

Аргументы

ORM\Fields\ScalarField $field Type "source".

Возвращает: false|callback

См. определение в файле sqlhelper.php строка 705

◆ getCurrentDateFunction()

getCurrentDateFunction ( )

abstract

Returns function for getting current date without time part.

Возвращает: string

Переопределяется в MssqlSqlHelper, MysqlCommonSqlHelper, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ getCurrentDateTimeFunction()

getCurrentDateTimeFunction ( )

abstract

Returns function for getting current time.

Возвращает: string

Переопределяется в MssqlSqlHelper, MysqlCommonSqlHelper, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ getDatetimeToDateFunction()

getDatetimeToDateFunction ( $value )

abstract

Returns function cast $value to datetime database type.

$value parameter is SQL unsafe.

Аргументы

string $value Database field or expression to cast.

Возвращает: string

Переопределяется в MssqlSqlHelper, MysqlCommonSqlHelper, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ getDateToCharFunction()

getDateToCharFunction ( $fieldName )

abstract

Returns function for converting database field or expression into string.

Result string will be in YYYY-MM-DD HH:MI:SS format.

$fieldName parameter is SQL unsafe.

Аргументы

string $fieldName Database field or expression.

Возвращает: string

См. также: SqlHelper::formatDate

Переопределяется в MssqlSqlHelper, MysqlCommonSqlHelper, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ getDescendingOrder()

getDescendingOrder ( )

Returns descending order specifier for ORDER BY clause.

Возвращает: string

Переопределяется в OracleSqlHelper и PgsqlSqlHelper.

См. определение в файле sqlhelper.php строка 746

◆ getFieldByColumnType()

getFieldByColumnType	(		$name,
			$type,
		array	$parameters = null )

abstract

Returns instance of a descendant from Entity\ScalarField that matches database type.

Аргументы

string	$name	Database column name.
mixed	$type	Database specific type.
array \| null	$parameters	Additional information.

Возвращает: \Bitrix\Main\ORM\Fields\ScalarField

Переопределяется в MssqlSqlHelper, MysqliSqlHelper, MysqlSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ getInsertIgnore()

getInsertIgnore	(	$tableName,
		$fields,
		$sql )

Makes an insert statement which will ignore duplicate keys errors.

@abstract

Аргументы

string	$tableName	Table to insert.
integer	$fields	Fields list in braces.
integer	$sql	Select or values sql.

Возвращает: string

Переопределяется в MysqliSqlHelper и PgsqlSqlHelper.

См. определение в файле sqlhelper.php строка 775

◆ getIsNullFunction()

getIsNullFunction	(		$expression,
			$result )

abstract

Returns function for testing database field or expressions against NULL value. When it is NULL then $result will be returned.

All parameters are SQL unsafe.

Аргументы

string	$expression	Database field or expression for NULL test.
string	$result	Database field or expression to return when $expression is NULL.

Возвращает: string

Переопределяется в MssqlSqlHelper, MysqlCommonSqlHelper, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ getLeftQuote()

getLeftQuote ( )

Returns an identificator escaping left character.

Возвращает: string

Переопределяется в MssqlSqlHelper, MysqlCommonSqlHelper, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

См. определение в файле sqlhelper.php строка 29

◆ getLengthFunction()

getLengthFunction ( $field )

abstract

Returns function for getting length of database field or expression.

$field parameter is SQL unsafe.

Аргументы

string $field Database field or expression.

Возвращает: string

Переопределяется в MssqlSqlHelper, MysqlCommonSqlHelper, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ getMatchAndExpression()

getMatchAndExpression	(		$values,
			$prefixSearch = false )

@abstract

Переопределяется в MysqliSqlHelper и PgsqlSqlHelper.

См. определение в файле sqlhelper.php строка 845

◆ getMatchFunction()

getMatchFunction	(		$field,
			$value )

@abstract

Переопределяется в MysqliSqlHelper и PgsqlSqlHelper.

См. определение в файле sqlhelper.php строка 837

◆ getMatchOrExpression()

getMatchOrExpression	(		$values,
			$prefixSearch = false )

@abstract

Переопределяется в MysqliSqlHelper и PgsqlSqlHelper.

См. определение в файле sqlhelper.php строка 853

◆ getOrderByField()

getOrderByField	(	string	$field,
		array	$values,
		callable	$callback,
		bool	$quote = true )

protected

Аргументы

string	$field
array	$values
callable	$callback
bool	$quote

Возвращает: string

Переопределяется в MysqliSqlHelper и PgsqlSqlHelper.

См. определение в файле sqlhelper.php строка 1021

◆ getOrderByIntField()

getOrderByIntField	(	string	$field,
		array	$values,
		bool	$quote = true )

Аргументы

string	$field
array	$values
bool	$quote

Возвращает: string

См. определение в файле sqlhelper.php строка 1008

◆ getOrderByStringField()

getOrderByStringField	(	string	$field,
		array	$values,
		bool	$quote = true )

Аргументы

string	$field
array	$values
bool	$quote

Возвращает: string

См. определение в файле sqlhelper.php строка 996

◆ getQueryDelimiter()

getQueryDelimiter ( )

abstract

Returns database specific query delimiter for batch processing.

Возвращает: string

Переопределяется в MssqlSqlHelper, MysqlCommonSqlHelper, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ getRandomFunction()

getRandomFunction ( )

Returns function for getting random number.

Возвращает: string

Переопределяется в PgsqlSqlHelper.

См. определение в файле sqlhelper.php строка 785

◆ getRegexpOperator()

getRegexpOperator	(		$field,
			$regexp )

Returns regexp expression.

All parameters are SQL unsafe.

@abstract

Аргументы

string	$field	Database field or expression.
string	$regexp	Regexp to match.

Возвращает: string

Переопределяется в MysqliSqlHelper и PgsqlSqlHelper.

См. определение в файле sqlhelper.php строка 815

◆ getRightQuote()

getRightQuote ( )

Returns an identificator escaping right character.

Возвращает: string

Переопределяется в MssqlSqlHelper, MysqlCommonSqlHelper, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

См. определение в файле sqlhelper.php строка 39

◆ getRowNumber()

getRowNumber ( $variableName )

@abstract

Переопределяется в MysqliSqlHelper и PgsqlSqlHelper.

См. определение в файле sqlhelper.php строка 917

◆ getSha1Function()

getSha1Function ( $field )

Returns function to generate sha1 hash.

$field parameter is SQL unsafe.

Аргументы

string $field Database field or expression.

Возвращает: string

Переопределяется в PgsqlSqlHelper.

См. определение в файле sqlhelper.php строка 799

◆ getSubstrFunction()

getSubstrFunction	(	$str,
		$from,
		$length = null )

Returns function for getting part of string.

If length is null or omitted, the substring starting from start until the end of the string will be returned.

$str and $from parameters are SQL unsafe.

Аргументы

string	$str	Database field or expression.
integer	$from	Start position.
integer	$length	Maximum length.

Возвращает: string

Переопределяется в MssqlSqlHelper.

См. определение в файле sqlhelper.php строка 201

◆ getTopSql()

getTopSql	(	$sql,
		$limit,
		$offset = 0 )

abstract

Transforms Sql according to $limit and $offset limitations.

You must specify $limit when $offset is set.

Аргументы

string	$sql	Sql text.
integer	$limit	Maximum number of rows to return.
integer	$offset	Offset of the first row to return, starting from 0.

Возвращает: string

Исключения

Main

ArgumentException

Переопределяется в MssqlSqlHelper, MysqlCommonSqlHelper, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ initRowNumber()

initRowNumber ( $variableName )

@abstract

Переопределяется в MysqliSqlHelper и PgsqlSqlHelper.

См. определение в файле sqlhelper.php строка 909

◆ prepareAssignment()

prepareAssignment	(	$tableName,
		$columnName,
		$value )

Builds the string for the SQL assignment operation of the given column.

Аргументы

string	$tableName	A table name.
string	$columnName	A column name.
string	$value	A value to assign.

Возвращает: string

См. определение в файле sqlhelper.php строка 422

◆ prepareBinds()

prepareBinds	(	array	$tableFields,
		array	$fields )

protected

Performs additional processing of CLOB fields.

Аргументы

ORM\Fields\ScalarField[]	$tableFields	Table fields.
array	$fields	Data fields.

Возвращает: array

Переопределяется в OracleSqlHelper.

См. определение в файле sqlhelper.php строка 408

◆ prepareCorrelatedUpdate()

prepareCorrelatedUpdate	(	$tableName,
		$tableAlias,
		$fields,
		$from,
		$where )

Builds correlated update DML.

@abstract

Аргументы

string	$tableName	A table name.
string	$tableAlias	A table alias.
array	$fields	Array("column" => "expression")[] Update columns list.
string	$from	Correlated tables.
string	$where	Where clause.

Возвращает: string

Переопределяется в MysqliSqlHelper и PgsqlSqlHelper.

См. определение в файле sqlhelper.php строка 934

◆ prepareDeleteLimit()

prepareDeleteLimit	(		$tableName,
		array	$primaryFields,
			$where,
		array	$order,
			$limit )

Builds the DML string for the SQL DELETE command for the given table with limited rows number.

@abstract

Аргументы

string	$tableName	A table name.
array	$primaryFields	Array("column")[] Primary key columns list.
string	$where	Sql where clause.
array	$order	Array("column" => asc\|desc)[] Sort order.
integer	$limit	Rows to delete count.

Возвращает: string (replace)

Переопределяется в MysqliSqlHelper и PgsqlSqlHelper.

См. определение в файле sqlhelper.php строка 901

◆ prepareInsert()

prepareInsert	(		$tableName,
		array	$fields,
			$returnAsArray = false )

Builds the strings for the SQL INSERT command for the given table.

Аргументы

string	$tableName	A table name.
array	$fields	Array("column" => $value)[].
bool	$returnAsArray

Возвращает: array (columnList, valueList, binds)

См. определение в файле sqlhelper.php строка 317

◆ prepareMerge()

prepareMerge	(		$tableName,
		array	$primaryFields,
		array	$insertFields,
		array	$updateFields )

abstract

Builds the strings for the SQL MERGE command for the given table.

Аргументы

string	$tableName	A table name.
array	$primaryFields	Array("column")[] Primary key columns list.
array	$insertFields	Array("column" => $value)[] What to insert.
array	$updateFields	Array("column" => $value)[] How to update.

Возвращает: array (merge)

Переопределяется в MssqlSqlHelper, MysqlCommonSqlHelper, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ prepareMergeMultiple()

prepareMergeMultiple	(		$tableName,
		array	$primaryFields,
		array	$insertRows )

Builds the DML strings for the SQL REPLACE INTO command for the given table.

@abstract

Аргументы

string	$tableName	A table name.
array	$primaryFields	Array("column")[] Primary key columns list.
array	$insertRows	Array(Array("column" => $value)[])[] Rows to insert.

Возвращает: array (replace)

Переопределяется в MysqliSqlHelper и PgsqlSqlHelper.

См. определение в файле sqlhelper.php строка 868

◆ prepareMergeSelect()

prepareMergeSelect	(		$tableName,
		array	$primaryFields,
		array	$selectFields,
			$select,
			$updateFields )

Builds the DML strings for the SQL INSERT INTO ON CONFLICT UPDATE command for the given table.

@abstract

Аргументы

string	$tableName	A table name.
array	$primaryFields	Array("column")[] Primary key columns list.
array	$selectFields
	$select
	$updateFields

Возвращает: string (replace)

Переопределяется в MysqliSqlHelper и PgsqlSqlHelper.

См. определение в файле sqlhelper.php строка 884

◆ prepareMergeValues()

prepareMergeValues	(	string	$tableName,
		array	$primaryFields,
		array	$insertRows,
		array	$updateFields = [] )

Returns prepared sql string for upsert multiple rows

Аргументы

string	$tableName	Table name
array	$primaryFields	Fields that can be conflicting keys (primary, unique keys)
array	$insertRows	Rows to insert [['FIELD_NAME' =>'value',...],...], Attention! use same columns in each row
array	$updateFields	Fields to update, if empty - update all fields, can be only field names, or fieldname => expression or fieldname => value

Возвращает: string

Исключения

Bitrix\Main\ArgumentException

См. определение в файле sqlhelper.php строка 950

◆ prepareUpdate()

prepareUpdate	(		$tableName,
		array	$fields )

Builds the strings for the SQL UPDATE command for the given table.

Аргументы

string	$tableName	A table name.
array	$fields	Array("column" => $value)[].

Возвращает: array (update, binds)

См. определение в файле sqlhelper.php строка 358

◆ quote()

quote ( $identifier )

Returns quoted identifier.

For example Title become :

Title for MySQL
"TITLE" for Oracle
[Title] for Ms SQL

Аргументы

string $identifier Table or Column name.

Возвращает: string

См. также: SqlHelper::getLeftQuote; SqlHelper::getRightQuote

Переопределяется в OracleSqlHelper и PgsqlSqlHelper.

См. определение в файле sqlhelper.php строка 65

◆ softCastTextToChar()

softCastTextToChar ( $fieldName )

abstract

Returns expression for text field being used in group or order

См. также: \Bitrix\Main\ORM\Query\Query::buildGroup; \Bitrix\Main\ORM\Query\Query::buildOrder

Аргументы

string $fieldName

Возвращает: string

Переопределяется в MssqlSqlHelper, MysqlCommonSqlHelper, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ values()

values ( $identifier )

Returns identifier for usage in VALUES.

@abstract

Аргументы

string $identifier Column name.

Возвращает: string

См. также: SqlHelper::quote

Переопределяется в MysqliSqlHelper и PgsqlSqlHelper.

См. определение в файле sqlhelper.php строка 829

Данные класса

◆ $connection

Connection $connection

protected

См. определение в файле sqlhelper.php строка 12

◆ $idCache

$idCache

protected

См. определение в файле sqlhelper.php строка 14

Bitrix-D7 23.9

Открытые члены

Защищенные члены

Защищенные данные

Подробное описание

Конструктор(ы)

◆ __construct()

Методы

◆ addDaysToDateTime()

◆ addSecondsToDateTime()

◆ castToChar()

◆ convertDateField()

◆ convertDatetimeField()

◆ convertFromDb()

◆ convertFromDbDate()

◆ convertFromDbDateTime()

◆ convertFromDbFloat()

◆ convertFromDbInteger()

◆ convertFromDbString()

◆ convertFromDbText()

◆ convertToDb()

◆ convertToDbDate()

◆ convertToDbDateTime()

◆ convertToDbFloat()

◆ convertToDbInteger()

◆ convertToDbString()

◆ convertToDbText()

◆ formatDate()

◆ forSql()

◆ getAliasLength()

◆ getAscendingOrder()

◆ getCharToDateFunction()

◆ getColumnTypeByField()

◆ getConcatFunction()

◆ getConditionalAssignment()

◆ getConverter()

◆ getCurrentDateFunction()

◆ getCurrentDateTimeFunction()

◆ getDatetimeToDateFunction()

◆ getDateToCharFunction()

◆ getDescendingOrder()

◆ getFieldByColumnType()

◆ getInsertIgnore()

◆ getIsNullFunction()

◆ getLeftQuote()

◆ getLengthFunction()

◆ getMatchAndExpression()

◆ getMatchFunction()

◆ getMatchOrExpression()

◆ getOrderByField()

◆ getOrderByIntField()

◆ getOrderByStringField()

◆ getQueryDelimiter()

◆ getRandomFunction()

◆ getRegexpOperator()

◆ getRightQuote()

◆ getRowNumber()

◆ getSha1Function()

◆ getSubstrFunction()

◆ getTopSql()

◆ initRowNumber()

◆ prepareAssignment()

◆ prepareBinds()

◆ prepareCorrelatedUpdate()

◆ prepareDeleteLimit()

◆ prepareInsert()

◆ prepareMerge()

◆ prepareMergeMultiple()

◆ prepareMergeSelect()

◆ prepareMergeValues()

◆ prepareUpdate()

◆ quote()

◆ softCastTextToChar()

◆ values()

Данные класса

◆ $connection

◆ $idCache