调用BatchExecuteStatement接口对一组数据执行批处理SQL语句-阿里云帮助中心

调用BatchExecuteStatement接口对一组数据执行批处理SQL语句。

接口说明

本接口当前仅支持华东 1（杭州）、华北 2（北京）地域的 Serverless 实例使用。
您可以使用具有不同参数集的 DML 语句对多条记录进行批量更新和插入操作。
与单独的插入和更新操作相比，批量操作可以显著提高性能。

调试

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

调试

授权信息

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

请求参数

名称	类型	必填	描述	示例值
SecretArn	string	是	Data API 账号的用户凭证，您可调用 DescribeSecrets 接口获取该参数的值。格式如下：`acs:rds:{{region}}:{{accountId}}:rds-db-credentials/{{secretName}}-{{6 digits random string}}`	acs:rds-api:cn-hangzhou:1266348003****:rds-db-credentials/mySecret-Uy**
ResourceArn	string	是	用于指向用户希望访问的资源，格式如下：`acs:rds:{{regionId}}:{{accountId}}:dbinstance/{{instanceId}}` 参数说明如下： regionId：地域 ID，可调用 DescribeSecrets 接口获取。 accountId：阿里云账号 ID，可调用 DescribeSecrets 接口获取。 instanceId：实例 ID。	acs:rds:cn-hangzhou:1266348003****:dbinstance/rm-1234567890abc**
Database	string	否	数据库名。	test
Sql	string	是	需要执行的 SQL 语句。说明 BatchExecuteStatement 接口通常多执行 INSERT 和 UPDATE 语句。	insert into users(name) values(:name)
TransactionId	string	否	已启动的事务 ID，您可调用 BeginTransaction 接口获取该参数的值。	8609**-94e1-45ce-8e25-354e3dd8**
ParameterSets	array	否	有关 SQL 语句的参数说明。
	array	否	其中一条 SQL 语句的参数说明。
	SqlParameter	否	参数值，详情请参见 SqlParameter 。

返回参数

名称	类型	描述	示例值
	object	返回参数如下。
RequestId	string	请求 ID。	CDAEE474-87E5-5AE3-A534-922F90D5867D
Success	boolean	请求是否成功，返回值如下： true：请求成功。 false：请求失败。	true
Code	string	状态码。	200
Message	string	错误信息。说明请求成功时该参数返回为空。	There is an error in the call.
Data	BatchExecuteStatementResult	请求返回数据，详情请参见 BatchExecuteStatementResult 。

示例

正常返回示例

JSON格式

{
  "RequestId": "CDAEE474-87E5-5AE3-A534-922F90D5867D",
  "Success": true,
  "Code": "200",
  "Message": "There is an error in the call.",
  "Data": {
    "GeneratedFieldsList": [
      [
        {
          "ArrayValue": "[item1, item2, item3]",
          "BlobValue": "aGVsbG8=",
          "BooleanValue": true,
          "IsNull": true,
          "LongValue": 3213212,
          "StringValue": "I am a string"
        }
      ]
    ]
  }
}

错误码

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