Подготовить вставку из выборки с обновлением SqlHelper::prepareMergeSelect
Модуль: main — подключать отдельно не нужно
Метод SqlHelper::prepareMergeSelect строит запрос, который добавляет строки из выборки SELECT или списка VALUES, а строки с совпадающим ключом обновляет. Метод prepareMergeValues использует его для готовых значений.
Сигнатура метода в классе Bitrix\Main\DB\SqlHelper:
public function prepareMergeSelect($tableName, array $primaryFields, array $selectFields, $select, $updateFields)
Параметры
Обязательные параметры обозначены *
| Параметр | Тип | Описание |
|---|---|---|
| tableName* | string |
Задает имя таблицы. Таблица должна существовать |
| primaryFields* | string[] |
Задает колонки уникального ключа. Реализация MySQL не использует параметр |
| selectFields* | string[] |
Задает колонки, в которые запрос добавляет значения. Метод берет имена в кавычки |
| select* | string |
Задает запрос SELECT или список VALUES (...). Метод подставляет значение в SQL без экранирования |
| updateFields* | array |
Задает значения для обновления в виде имя колонки => значение. Метод преобразует значения по типам колонок и подставляет объект SqlExpression собранным SQL-фрагментом |
Типы tableName, select и updateFields в таблице описывают назначение аргументов. Сигнатура PHP не объявляет их.
Возвращаемое значение
Метод возвращает строку string — текст запроса.
| Реализация | Запрос |
|---|---|
MysqliSqlHelper |
INSERT INTO ... (<selectFields>) <select> ON DUPLICATE KEY UPDATE ... |
PgsqlSqlHelper |
INSERT INTO ... (<selectFields>) <select> ON CONFLICT (<primaryFields>) DO UPDATE SET ... |
Колонку updateFields, которой нет в таблице, метод пропускает и выдает предупреждение E_USER_WARNING.
В выражениях updateFields указывайте колонку вместе с именем таблицы, например demo_api_counters.CNT. Если в выборке есть колонка с тем же именем, MySQL вернет ошибку неоднозначного имени.
Исключения
| Исключение | Когда возникает |
|---|---|
Bitrix\Main\NotImplementedException |
Соединение работает не с MySQL и не с PostgreSQL. Базовый класс не реализует метод |
Bitrix\Main\DB\SqlQueryException |
В MySQL таблицы нет |
Bitrix\Main\DB\ConnectionException |
Подключиться к базе данных не удалось |
Bitrix\Main\ArgumentException |
Код передал для колонки даты и времени непустое значение, но не объект Bitrix\Main\Type\Date |
\Error |
Код передал для колонки даты без времени непустое значение, но не объект Bitrix\Main\Type\Date |
Примеры
Пример. Код копирует строки из одной рабочей таблицы в другую и при совпадении ключа увеличивает счетчик:
<?php
use Bitrix\Main\Application;
use Bitrix\Main\DB\SqlExpression;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$connection = Application::getConnection();
$helper = $connection->getSqlHelper();
$connection->queryExecute('CREATE TABLE demo_api_counters (CODE VARCHAR(20) NOT NULL PRIMARY KEY, CNT INT NOT NULL)');
$connection->queryExecute('CREATE TABLE demo_api_counters_new (CODE VARCHAR(20) NOT NULL, CNT INT NOT NULL)');
try
{
$connection->queryExecute("INSERT INTO demo_api_counters (CODE, CNT) VALUES ('kg', 1)");
$connection->queryExecute("INSERT INTO demo_api_counters_new (CODE, CNT) VALUES ('kg', 5), ('m', 7)");
$sql = $helper->prepareMergeSelect(
'demo_api_counters',
['CODE'],
['CODE', 'CNT'],
'SELECT CODE, CNT FROM demo_api_counters_new',
['CNT' => new SqlExpression('?# + 1', 'demo_api_counters.CNT')]
);
$connection->queryExecute($sql);
print_r($connection->query('SELECT CODE, CNT FROM demo_api_counters ORDER BY CODE')->fetchAll());
}
finally
{
$connection->dropTable('demo_api_counters');
$connection->dropTable('demo_api_counters_new');
}