Добавить несколько строк Connection::addMulti
Модуль: main — подключать отдельно не нужно
Метод Connection::addMulti добавляет несколько строк в таблицу одним запросом INSERT. Метод экранирует значения и преобразует их по типам колонок таблицы, как add.
Сигнатура метода в классе Bitrix\Main\DB\Connection:
public function addMulti($tableName, $rows, $identity = "ID")
Параметры
Обязательные параметры обозначены *
| Параметр | Тип | Описание |
|---|---|---|
| tableName* | string |
Задает имя таблицы |
| rows* | array[] |
Задает строки. Каждая строка — массив имя колонки => значение. Строки могут содержать разный набор колонок |
| identity | string |
Метод не использует параметр. По умолчанию — ID |
Типы в таблице описывают назначение аргументов. Сигнатура PHP не объявляет их.
Возвращаемое значение
Метод возвращает результат getInsertedId после запроса.
Метод собирает список колонок из всех строк. Если в строке нет колонки, которая есть в другой строке, метод подставляет DEFAULT. Колонку, которой нет в таблице, метод пропускает и выдает предупреждение E_USER_WARNING.
Метод не делит строки на части. Настройки сервера базы данных ограничивают размер одного запроса.
Исключения
| Исключение | Когда возникает |
|---|---|
Bitrix\Main\DB\SqlQueryException |
База данных вернула ошибку при выполнении запроса |
Bitrix\Main\DB\DuplicateEntryException |
Строка нарушила уникальность ключа. Класс наследует SqlQueryException |
Bitrix\Main\DB\ConnectionException |
Подключиться к базе данных не удалось |
Bitrix\Main\ArgumentException |
Код передал для колонки даты и времени непустое значение, но не объект Bitrix\Main\Type\Date |
\Error |
Код передал для колонки даты без времени непустое значение, но не объект Bitrix\Main\Type\Date |
Примеры
Пример. Код добавляет три строки одним запросом. У второй строки нет колонки SORT, и база данных подставит значение по умолчанию:
<?php
use Bitrix\Main\Application;
use Bitrix\Main\ORM\Fields\IntegerField;
use Bitrix\Main\ORM\Fields\StringField;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$connection = Application::getConnection();
$connection->createTable(
'demo_api_units',
[
'ID' => new IntegerField('ID'),
'CODE' => new StringField('CODE', ['size' => 20]),
'SORT' => (new IntegerField('SORT'))->configureNullable(),
],
['ID'],
['ID']
);
try
{
$connection->addMulti('demo_api_units', [
['CODE' => 'kg', 'SORT' => 10],
['CODE' => 'm'],
['CODE' => 'l', 'SORT' => 30],
]);
echo $connection->queryScalar('SELECT COUNT(*) FROM demo_api_units');
}
finally
{
$connection->dropTable('demo_api_units');
}