更新时间：2024-06-20 GMT+08:00
批量写请求
功能介绍
批量写请求，其中可以携带一或多个表的不同kv的写操作，上传kv/删除kv。
URI
POST /v1/batch-write-kv
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
store_name |
否 |
String |
仓名，全域唯一，不同租户的仓名不能相同。
说明：
"-"不能出现在名字头部或尾部 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
table_opers |
是 |
Array of table_batch objects |
行操作数组，可以是多个表的操作。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
table_name |
是 |
String |
表名，仓内唯一。
|
kv_opers |
是 |
Array of oper_item objects |
kv操作数组。 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
unprocessed_opers |
Array of table_oper_ids objects |
未处理的操作列表。 |
参数 |
参数类型 |
描述 |
|---|---|---|
table_name |
String |
表名，仓内唯一。
|
kv_oper_ids |
kv_oper_ids object |
kv操作数组。 |
请求示例
批量写请求，向test-table-1表中插入和删除一个kv
POST https://{endpoint}/v1/batch-write-kv
{
"table_opers" : [ {
"table_batch" : {
"table_name" : "test_table_1",
"kv_opers" : [ {
"put_kv" : {
"oper_id" : 1,
"kv_doc" : {
"owner" : "user_3",
"filename" : "test_file_3"
}
}
}, {
"delete_kv" : {
"oper_id" : 2,
"primary_key" : {
"owner" : "user_2",
"filename" : "test_file_2"
}
}
} ]
}
} ]
}
响应示例
无
状态码
状态码 |
描述 |
|---|---|
200 |
表示批量写请求请求成功 |
400 |
BatchExceedLimit |
错误码
请参见错误码。
父主题： KV接口
