addBatch 创建多条记录

addBatch 方法用于向数据库表中插入多行新的记录。

Luwak >= 3.0.0, asm.so >= 0.1.4

API

公共参数 metas 对象

名称	类型	描述
token	string	访问令牌，当需要授权才能访问时为必填
signature	string	签名
appKey	string	当需要签名时为必填
timestamp	string, number	时间戳，当校验时间误差范围时为必填

请求参数

名称	类型	描述
method	string	API 名称
params	array	API 参数

method 命名规范是 $entity.addBatch

params 是一个数组，该数据包含多个对象。

响应结果

返回受影响的行数。

示例

场景描述

向品牌表中插入多个品牌。

请求

{
  "jsonrpc": "2.0",
  "method": "smartPanda.mdh.brand.addBatch",
  "params": [
    {
      "name": "Louis Vuitton"
    },
    {
      "name": "Channel"
    },
    {
      "name": "Gucci"
    },
    {
      "name": "Dior"
    },
    {
      "name": "Tom Ford"
    },
    {
      "name": "Hermès"
    },
    {
      "name": "Bvlgari"
    },
    {
      "name": "Salvatore Ferragamo"
    },
    {
      "name": "Swarovski"
    }
  ],
  "metas": {
    "token": "44ea16b7-3aa1-41a5-81da-8ee9d2b840c2",
    "signature": "5f59492d2f9cd983361c26ab4550d670",
    "appKey": "NSEA4ETIpBlyB2l9",
    "timestamp": 1740553003125
  },
  "id": "769be428-f84f-4a64-a171-5260261d3c63"
}

响应

{
  "jsonrpc": "2.0",
  "result": 9,
  "id": "769be428-f84f-4a64-a171-5260261d3c63"
}

实体定义

smart_panda 库中 brand 表的定义如下

CREATE TABLE `brand`
(
    `id`   int AUTO_INCREMENT,
    `name` varchar(20),
    PRIMARY KEY (`id`)
);

entity 名称是 smartPanda.mdh.brand

实际执行的 SQL

Prepare   INSERT INTO smart_panda.brand (name) VALUES (?), (?), (?), (?), (?), (?), (?), (?), (?)
Execute   INSERT INTO smart_panda.brand (name) VALUES ('Louis Vuitton'), ('Channel'), ('Gucci'), ('Dior'), ('Tom Ford'), ('Hermès'), ('Bvlgari'), ('Salvatore Ferragamo'), ('Swarovski')