文档

InsertList - 插入多条数据

更新时间:

调用InsertList批量插入数据。

接口说明

本接口当前仅支持华东 1(杭州)、华北 2(北京)地域的 Serverless 实例使用。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
SecretArnstring

Data API 账号的用户凭证,您可调用 DescribeSecrets 接口获取该参数的值。格式如下:acs:rds:{{region}}:{{accountId}}:rds-db-credentials/{{secretName}}-{{6 digits random string}}

acs:rds-api:cn-hangzhou:1266348003******:rds-db-credenti***/mySecret-Uy****
ResourceArnstring

用于指向用户希望访问的资源,格式如下:acs:rds:{{regionId}}:{{accountId}}:dbinstance/{{instanceId}}

参数说明如下:

  • regionId:地域 ID,可调用 DescribeSecrets 接口获取。
  • accountId:阿里云账号 ID,可调用 DescribeSecrets 接口获取。
  • instanceId:实例 ID。
acs:rds:cn-hangzhou:1266348003******:dbinstance/rm-1234567890abc****
Databasestring

数据库名称。

test_db
Tablestring

表名称。

user
TransactionIdstring

需要提交的事务 ID,您可调用 BeginTransaction 接口获取该参数的值。

8609****-94e1-45ce-8e25-354e3dd8****
Recordsobject []

要批量插入的数据,数据结构为 array 数组,每一项为一条记录

object

要插入的数据,数据结构为 map
key 为表字段名称,value 为字段值

示例:{ name: "jack", age: 18 }

any

插入数据的 value 值,任意类型。

test_value

返回参数

名称类型描述示例值
object

返回参数。

RequestIdstring

请求 ID。

D2FEE6D7-DCA6-57B4-946A-9E670B773518
Successboolean

请求是否成功,返回值如下:

  • true:请求成功。
  • false:请求失败。
true
Codestring

状态码。

200
Messagestring

错误信息。

说明 请求成功时该参数返回为空。
There is an error in the call.
DataInsertListResult

InsertList 的返回值,详情请参见 InsertListResult

示例

正常返回示例

JSON格式

{
  "RequestId": "D2FEE6D7-DCA6-57B4-946A-9E670B773518",
  "Success": true,
  "Code": "200",
  "Message": "There is an error in the call.",
  "Data": {
    "NumberOfRecordsUpdated": 5,
    "AutoIncrementKeys": [
      2
    ]
  }
}

错误码

访问错误中心查看更多错误码。