# MssqlSqlHelper::prepareMergeValues()

URL: https://chugunov.pro/api-bitrix/main/db/mssqlsqlhelper/preparemergevalues/
Проверено на 1С-Битрикс 25.x, обновлено 03.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией 1С-Битрикс.

Класс: [`\Bitrix\Main\DB\MssqlSqlHelper`](https://chugunov.pro/api-bitrix/main/db/mssqlsqlhelper/)
Модуль: Main.
Свойства элемента: method, public.

## Сигнатура

```php
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`

Оригинал в официальной документации: https://docs.1c-bitrix.ru/api/classes/Bitrix-Main-DB-MssqlSqlHelper.html