SqlHelper::prepareMergeMultiple() — параметры и описание

Сигнатура

public prepareMergeMultiple(string $tableName, array<string|int, mixed> $primaryFields, array<string|int, mixed> $insertRows) : array<string|int, mixed>

Описание

Формирует DML-строки для SQL-команды REPLACE INTO для указанной таблицы.

Параметры

$tableName string

Имя таблицы.

$primaryFields array<string|int, mixed>

Array("column")[] Список столбцов первичного ключа.

$insertRows array<string|int, mixed>

Array(Array("column" => $value)[])[] Строки для вставки.

Возвращаемое значение

array<string|int, mixed>

Как применяется в SqlHelper

SqlHelper::prepareMergeMultiple() — метод класса \Bitrix\Main\DB\SqlHelper модуля «Главный модуль».

Метод объекта: сначала нужен экземпляр SqlHelper.

use Bitrix\Main\DB\SqlHelper;

/** @var SqlHelper $object */
$tableName = '';
$primaryFields = [];
$insertRows = [];
$result = $object->prepareMergeMultiple($tableName, $primaryFields, $insertRows);
// $result: array<string|int, mixed>

Другие методы SqlHelper

addDaysToDateTime() Возвращает функцию для добавления временного интервала в днях к $from.
addSecondsToDateTime() Возвращает функцию для добавления временного интервала в секундах к $from.
castToChar() Возвращает выражение CAST для преобразования поля или выражения в строку
convertDateField()
convertDatetimeField()
convertFromDb() Возвращает $value, преобразованный в тип согласно типу $field.
convertFromDbDate()
convertFromDbDateTime()
convertFromDbFloat()
convertFromDbInteger()
convertFromDbString()
convertFromDbText()

prepareMergeMultiple() есть и у других классов модуля «Главный модуль»: MssqlSqlHelper, MysqliSqlHelper, OracleSqlHelper, PgsqlSqlHelper.