微信小程序云开发 API数据库·更新记录
databaseUpdate
本接口应在服务器端调用，详细说明参见服务端API。
数据库更新记录
请求地址
POST https://api.weixin.qq.com/tcb/databaseupdate?access_token=ACCESS_TOKEN
请求参数
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | 接口调用凭证 | |
| env | string | 是 | 云环境ID | |
| query | string | 是 | 数据库操作语句 |
返回值
Object
返回的 JSON 数据包
| 属性 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
| matched | number | 更新条件匹配到的结果数 |
| modified | number | 修改的记录数，注意：使用set操作新插入的数据不计入修改数目 |
| id | string | 新插入记录的id，注意：只有使用set操作新插入数据时这个字段会有值 |
errcode 的合法值
| 值 | 说明 | 最低版本 |
|---|---|---|
| 0 | 请求成功 | |
| -1 | 系统错误 | |
| -1000 | 系统错误 | |
| 40014 | AccessToken 不合法 | |
| 40097 | 请求参数错误 | |
| 40101 | 缺少必填参数 | |
| 41001 | 缺少AccessToken | |
| 42001 | AccessToken过期 | |
| 43002 | HTTP METHOD 错误 | |
| 44002 | POST BODY 为空 | |
| 47001 | POST BODY 格式错误 | |
| 85088 | 该APP未开通云开发 | |
| 其他错误码 | 云开发错误码 |
请求数据示例1: 操作集合
{
"env":"test2-4a89da",
"query": "db.collection(\"geo\").where({age:14}).update({data:{age: _.inc(1)}})"
}
返回数据示例1: 操作集合
{
"errcode": 0,
"errmsg": "ok",
"matched": 1,
"modified": 1,
"id": ""
}
请求数据示例2: 更新一条记录
{
"env":"test2-4a89da",
"query": "db.collection(\"geo\").doc(\"56abd6d5-9daf-4fc7-af05-eca13933f1aa\").update({data:{age: 10}})"
}
返回数据示例2: 更新一条记录
{
"errcode": 0,
"errmsg": "ok",
"matched": 1,
"modified": 1,
"id": ""
}
请求数据示例3: 更新替换一条记录
{
"env":"test2-4a89da",
"query": "db.collection(\"geo\").doc(\"be62d9c4-43ec-4dc6-8ca1-30b206eeed24\").set({data: {
description: \"set\",
done: true
}})"
}
返回数据示例3: 更新替换一条记录
{
"errcode": 0,
"errmsg": "ok",
"matched": 0,
"modified": 0,
"id": "be62d9c4-43ec-4dc6-8ca1-30b206eeed24"
}
数据库操作语句说明
数据库操作语句语法与数据库 API相同