Подготовить вставку без ошибки дубликата SqlHelper::getInsertIgnore
Модуль: main — подключать отдельно не нужно
Метод SqlHelper::getInsertIgnore строит запрос INSERT, который пропускает строки с уже существующим ключом вместо ошибки.
Сигнатура метода в классе Bitrix\Main\DB\SqlHelper:
public function getInsertIgnore($tableName, $fields, $sql)
Параметры
Обязательные параметры обозначены *
| Параметр | Тип | Описание |
|---|---|---|
| tableName* | string |
Задает имя таблицы |
| fields* | string |
Задает список колонок в скобках, например (CODE, CNT) |
| sql* | string |
Задает запрос SELECT или список VALUES, например VALUES ('kg', 1) |
Типы в таблице описывают назначение аргументов. Сигнатура PHP не объявляет их.
Метод склеивает аргументы без пробелов, кавычек и экранирования. Добавьте пробелы в начало fields и sql, возьмите имена в кавычки через quote и экранируйте значения.
Возвращаемое значение
Метод возвращает строку string — текст запроса.
| Реализация | Запрос |
|---|---|
MysqliSqlHelper |
INSERT IGNORE INTO <tableName><fields><sql> |
PgsqlSqlHelper |
INSERT INTO <tableName><fields><sql> ON CONFLICT DO NOTHING |
Исключения
| Исключение | Когда возникает |
|---|---|
Bitrix\Main\NotImplementedException |
Соединение работает не с MySQL и не с PostgreSQL. Базовый класс не реализует метод |
Примеры
Пример. Код дважды добавляет строку с одним ключом. Второй запрос не вызывает ошибку:
<?php
use Bitrix\Main\Application;
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)');
try
{
$sql = $helper->getInsertIgnore(
$helper->quote('demo_api_counters'),
' (' . $helper->quote('CODE') . ', ' . $helper->quote('CNT') . ')',
" VALUES ('" . $helper->forSql('kg') . "', 1)"
);
$connection->queryExecute($sql);
$connection->queryExecute($sql);
echo $connection->queryScalar('SELECT COUNT(*) FROM demo_api_counters');
}
finally
{
$connection->dropTable('demo_api_counters');
}
Код выведет 1.
Смотрите также
Была ли статья полезна?
Предыдущая
Следующая