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

Сигнатура

public prepareMergeValues(string $tableName, array<string|int, mixed> $primaryFields, array<string|int, mixed> $insertRows[, array<string|int, mixed> $updateFields = [] ]) : string

Описание

Возвращает подготовленную SQL-строку для upsert нескольких строк.

Параметры

$tableName string

Имя таблицы.

$primaryFields array<string|int, mixed>

Поля, которые могут быть конфликтующими ключами (первичные, уникальные ключи).

$insertRows array<string|int, mixed>

Строки для вставки [['FIELD_NAME' =>'value',...],...], Внимание! используйте одни и те же столбцы в каждой строке.

$updateFields array<string|int, mixed> = []

Поля для обновления; если пусто — обновляются все поля; могут быть только именами полей, либо fieldname => expression, либо fieldname => value.

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

string

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

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

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

use Bitrix\Main\DB\SqlHelper;

/** @var SqlHelper $object */
$tableName = '';
$primaryFields = [];
$insertRows = [];
$result = $object->prepareMergeValues($tableName, $primaryFields, $insertRows);
// $result: string

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

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

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