快速批量更新(quickUpdateMany)
更新时间:2024年9月24日 09:14
浏览:441
快速批量更新多个对象或数组到数据库
public function quickUpdateMany(string $table, array $objects, $primaryKey = null): int
参数:
- string $table - 表名
- array $objects - 要插入数据库的对象数组或二维数组,对象属性或数组锓名需要和该表字段一致
- null | string | array $primaryKey 主键或指定键名更新,未指定时自动取表的主键
返回值:
- int - 更新的行数,如果数据无变化,则返回0,更新失败时抛出异常
快速批量更新方法没有预先编译 SQL 横板,而是直接生成 SQL,但插入的数据会通过 PDO 提供的 quote 方法处理 防止注入。
因为少了编译 SQL 的步骤,快速批量更新方法执行速度更快。MYSQL原生不支持快速批量更新,底层使用 case when 实现。更新的字段和行数较多时,最终生成的SQL语句长度会指数级快速增长,MYSQL解析时间会变长,实际项目中跟据具体情况调整,一般几百条执行时是比较划算的。
如果更新条件是主键或唯一键,且数据库为 MySQL时,更好的方案是用 替换 章节下的 快速批量替换(quickReplaceMany)
对象数组形式:
$objs = [];
$obj1 = new stdClass();
$obj1->id = 'cf8ee5b8-9b8f-11ec-9b24-0242ac180065';
$obj1->name = '马云';
$obj1->age = 51;
$objs[] = $obj1;
$obj2 = new stdClass();
$obj1->id = 'd8c5844c-9e12-11ec-a3cb-0242ac180065';
$obj2->name = '刘强东';
$obj1->age = 41;
$objs[] = $obj2;
// 更多对象 ...
$effectRows = Be::getDb()->quickUpdateMany('user', $objs);
将执行 SQL
UPDATE
`user`
SET
`name` = CASE `id`
WHEN 'cf8ee5b8-9b8f-11ec-9b24-0242ac180065' THEN '马云'
WHEN 'd8c5844c-9e12-11ec-a3cb-0242ac180065' THEN '刘强东'
END,
`age` = CASE `id`
WHEN 'cf8ee5b8-9b8f-11ec-9b24-0242ac180065' THEN 51
WHEN 'd8c5844c-9e12-11ec-a3cb-0242ac180065' THEN 41
END
WHERE
`id` IN (
'cf8ee5b8-9b8f-11ec-9b24-0242ac180065',
'd8c5844c-9e12-11ec-a3cb-0242ac180065'
)
二维数组形式:
$arrs = [
[
'id' => 'cf8ee5b8-9b8f-11ec-9b24-0242ac180065',
'name' => '马云',
],
[
'id' => 'd8c5844c-9e12-11ec-a3cb-0242ac180065',
'name' => '刘强东',
]
];
$effectRows = Be::getDb()->quickIUpdateMany('user', $arrs);
按非主键更新
$objs = [];
$obj1 = new stdClass();
$obj1->name = '马云';
$obj1->age = 51;
$objs[] = $obj1;
$obj2 = new stdClass();
$obj2->name = '刘强东';
$obj1->age = 41;
$objs[] = $obj2;
// 更多对象 ...
$effectRows = Be::getDb()->quickUpdateMany('user', $objs, 'name');
将执行 SQL
UPDATE
`user`
SET
`age` = CASE `name`
WHEN '马云' THEN 51
WHEN '刘强东' THEN 41
END
WHERE
`name` IN (
'马云',
'刘强东'
)
按多个非主键更新
$objs = [];
$obj1 = new stdClass();
$obj1->name = '马云';
$obj1->age = 51;
$obj1->sex = '男';
$objs[] = $obj1;
$obj2 = new stdClass();
$obj2->name = '刘强东';
$obj1->age = 41;
$obj1->sex = '男';
$objs[] = $obj2;
// 更多对象 ...
$effectRows = Be::getDb()->quickUpdateMany('user', $objs, ['name', 'sex']);
将执行 SQL
UPDATE
`user`
SET
`age` = CASE
WHEN `name`= '马云' AND `sex`='男' THEN 51
WHEN `name`='刘强东' AND `sex`='男' THEN 41
END
WHERE
(`name`, `sex`) IN (
('马云', '男'),
('刘强东', '男')
)