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

Открытые члены
	__construct (Connection $connection)
	getLeftQuote ()
	getRightQuote ()
	getAliasLength ()
	quote ($identifier)
	getQueryDelimiter ()
	forSql ($value, $maxLength=0)
	convertToDbBinary ($value)
	convertToFullText ($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, $size=8)
	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 ($field, string $value)
	getInsertIgnore ($tableName, $fields, $sql)
	getRandomFunction ()
	getSha1Function ($field)
	getRegexpOperator ($field, $regexp)
	getIlikeOperator ($field, $value)
	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)
	getQueryTables (string $sql, int $maxLevel=-1)
	isBigType ($type)

Защищенные члены
	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 строка 168

◆ 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, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ castToChar()

castToChar ( $fieldName )

abstract

Returns CAST expression for converting field or expression into string

Аргументы

string $fieldName

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

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

◆ convertDateField()

convertDateField ( $value )

Аргументы

string $value Value fetched.

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

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

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

◆ convertDatetimeField()

convertDatetimeField ( $value )

Аргументы

string $value Value fetched.

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

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

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

◆ 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 строка 504

◆ convertFromDbDate()

convertFromDbDate ( $value )

Аргументы

$value

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

Исключения

Main

ObjectException

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

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

◆ convertFromDbDateTime()

convertFromDbDateTime ( $value )

Аргументы

$value

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

Исключения

Main

ObjectException

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

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

◆ convertFromDbFloat()

convertFromDbFloat	(		$value,
			$scale = null )

Аргументы

	$value
int	$scale

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

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

◆ convertFromDbInteger()

convertFromDbInteger ( $value )

Аргументы

$value

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

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

◆ convertFromDbString()

convertFromDbString	(		$value,
			$length = null )

Аргументы

string	$value
int	$length

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

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

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

◆ convertFromDbText()

convertFromDbText ( $value )

Аргументы

$value

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

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

◆ 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 строка 461

◆ convertToDbBinary()

convertToDbBinary ( $value )

Returns binary safe data representation.

Аргументы

string $value Value to be encoded.

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

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

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

◆ 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 строка 632

◆ 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 строка 667

◆ 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 строка 549

◆ convertToDbInteger()

convertToDbInteger	(		$value,
			$size = 8 )

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

Аргументы

mixed	$value	Value to be converted.
int	$size	Size in bytes.

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

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

◆ 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 строка 581

◆ 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 строка 609

◆ convertToFullText()

convertToFullText	(		$value,
			$maxLength = 0 )

Returns full text safe data representation.

Аргументы

string	$value	Value to be cut to safe full text length.
integer	$maxLength	Limits string length if set.

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

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

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

◆ 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, 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, OracleSqlHelper и PgsqlSqlHelper.

◆ getAliasLength()

getAliasLength ( )

abstract

Returns maximum length of an alias in a select statement

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

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

◆ getAscendingOrder()

getAscendingOrder ( )

Returns ascending order specifier for ORDER BY clause.

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

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

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

◆ 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, 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, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ getConditionalAssignment()

getConditionalAssignment	(		$field,
		string	$value )

Аргументы

string \| SqlExpression	$field
string	$value

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

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

◆ 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 строка 739

◆ getCurrentDateFunction()

getCurrentDateFunction ( )

abstract

Returns function for getting current date without time part.

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

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

◆ getCurrentDateTimeFunction()

getCurrentDateTimeFunction ( )

abstract

Returns function for getting current time.

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

Переопределяется в MssqlSqlHelper, 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, 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, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ getDescendingOrder()

getDescendingOrder ( )

Returns descending order specifier for ORDER BY clause.

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

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

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

◆ 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, OracleSqlHelper и PgsqlSqlHelper.

◆ getIlikeOperator()

getIlikeOperator	(		$field,
			$value )

Returns case insensitive like expression.

All parameters are SQL unsafe.

@abstract

Аргументы

string	$field	Database field or expression.
string	$value	String to match.

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

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

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

◆ 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 строка 809

◆ 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, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ getLeftQuote()

getLeftQuote ( )

Returns an identificator escaping left character.

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

Переопределяется в MssqlSqlHelper, 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, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ getMatchAndExpression()

getMatchAndExpression	(		$values,
			$prefixSearch = false )

@abstract

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

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

◆ getMatchFunction()

getMatchFunction	(		$field,
			$value )

@abstract

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

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

◆ getMatchOrExpression()

getMatchOrExpression	(		$values,
			$prefixSearch = false )

@abstract

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

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

◆ 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 строка 1071

◆ getOrderByIntField()

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

Аргументы

string	$field
array	$values
bool	$quote

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

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

◆ getOrderByStringField()

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

Аргументы

string	$field
array	$values
bool	$quote

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

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

◆ getQueryDelimiter()

getQueryDelimiter ( )

abstract

Returns database specific query delimiter for batch processing.

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

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

◆ getQueryTables()

getQueryTables	(	string	$sql,
		int	$maxLevel = -1 )

Аргументы

string	$sql
int	$maxLevel

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

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

◆ getRandomFunction()

getRandomFunction ( )

Returns function for getting random number.

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

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

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

◆ 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 строка 849

◆ getRightQuote()

getRightQuote ( )

Returns an identificator escaping right character.

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

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

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

◆ getRowNumber()

getRowNumber ( $variableName )

@abstract

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

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

◆ getSha1Function()

getSha1Function ( $field )

Returns function to generate sha1 hash.

$field parameter is SQL unsafe.

Аргументы

string $field Database field or expression.

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

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

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

◆ 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 строка 226

◆ 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, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ initRowNumber()

initRowNumber ( $variableName )

@abstract

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

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

◆ isBigType()

isBigType ( $type )

Checks is the field type is BIG

Аргументы

$type

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

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

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

◆ 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 строка 446

◆ 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 строка 432

◆ 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 строка 984

◆ 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 строка 951

◆ 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 строка 342

◆ 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, 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 строка 918

◆ 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 строка 934

◆ 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 строка 1000

◆ 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 строка 382

◆ 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, MysqliSqlHelper, OracleSqlHelper и PgsqlSqlHelper.

◆ values()

values ( $identifier )

Returns identifier for usage in VALUES.

@abstract

Аргументы

string $identifier Column name.

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

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

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

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

Поля

◆ $connection

$connection

protected

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

◆ $idCache

$idCache

protected

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

Объявления и описания членов класса находятся в файле:

C:/bitrix/modules/main/lib/db/sqlhelper.php

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

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

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

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

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

◆ __construct()

Методы

◆ addDaysToDateTime()

◆ addSecondsToDateTime()

◆ castToChar()

◆ convertDateField()

◆ convertDatetimeField()

◆ convertFromDb()

◆ convertFromDbDate()

◆ convertFromDbDateTime()

◆ convertFromDbFloat()

◆ convertFromDbInteger()

◆ convertFromDbString()

◆ convertFromDbText()

◆ convertToDb()

◆ convertToDbBinary()

◆ convertToDbDate()

◆ convertToDbDateTime()

◆ convertToDbFloat()

◆ convertToDbInteger()

◆ convertToDbString()

◆ convertToDbText()

◆ convertToFullText()

◆ formatDate()

◆ forSql()

◆ getAliasLength()

◆ getAscendingOrder()

◆ getCharToDateFunction()

◆ getColumnTypeByField()

◆ getConcatFunction()

◆ getConditionalAssignment()

◆ getConverter()

◆ getCurrentDateFunction()

◆ getCurrentDateTimeFunction()

◆ getDatetimeToDateFunction()

◆ getDateToCharFunction()

◆ getDescendingOrder()

◆ getFieldByColumnType()

◆ getIlikeOperator()

◆ getInsertIgnore()

◆ getIsNullFunction()

◆ getLeftQuote()

◆ getLengthFunction()

◆ getMatchAndExpression()

◆ getMatchFunction()

◆ getMatchOrExpression()

◆ getOrderByField()

◆ getOrderByIntField()

◆ getOrderByStringField()

◆ getQueryDelimiter()

◆ getQueryTables()

◆ getRandomFunction()

◆ getRegexpOperator()

◆ getRightQuote()

◆ getRowNumber()

◆ getSha1Function()

◆ getSubstrFunction()

◆ getTopSql()

◆ initRowNumber()

◆ isBigType()

◆ prepareAssignment()

◆ prepareBinds()

◆ prepareCorrelatedUpdate()

◆ prepareDeleteLimit()

◆ prepareInsert()

◆ prepareMerge()

◆ prepareMergeMultiple()

◆ prepareMergeSelect()

◆ prepareMergeValues()

◆ prepareUpdate()

◆ quote()

◆ softCastTextToChar()

◆ values()

Поля

◆ $connection