databaseUpdate

本接口应在服务器端调用,详细说明参见服务端API

数据库更新记录

请求地址

  1. POST https://api.weixin.qq.com/tcb/databaseupdate?access_token=ACCESS_TOKEN

请求参数

属性类型默认值必填说明
access_tokenstring接口调用凭证
envstring云环境ID
querystring数据库操作语句

返回值

Object

返回的 JSON 数据包

属性类型说明
errcodenumber错误码
errmsgstring错误信息
matchednumber更新条件匹配到的结果数
modifiednumber修改的记录数,注意:使用set操作新插入的数据不计入修改数目
idstring新插入记录的id,注意:只有使用set操作新插入数据时这个字段会有值

errcode 的合法值

说明最低版本
0请求成功
-1系统错误
-1000系统错误
40014AccessToken 不合法
40097请求参数错误
40101缺少必填参数
41001缺少AccessToken
42001AccessToken过期
43002HTTP METHOD 错误
44002POST BODY 为空
47001POST BODY 格式错误
85088该APP未开通云开发
其他错误码云开发错误码

请求数据示例1: 操作集合

  1. {
  2. "env":"test2-4a89da",
  3. "query": "db.collection(\"geo\").where({age:14}).update({data:{age: _.inc(1)}})"
  4. }

返回数据示例1: 操作集合

  1. {
  2. "errcode": 0,
  3. "errmsg": "ok",
  4. "matched": 1,
  5. "modified": 1,
  6. "id": ""
  7. }

请求数据示例2: 更新一条记录

  1. {
  2. "env":"test2-4a89da",
  3. "query": "db.collection(\"geo\").doc(\"56abd6d5-9daf-4fc7-af05-eca13933f1aa\").update({data:{age: 10}})"
  4. }

返回数据示例2: 更新一条记录

  1. {
  2. "errcode": 0,
  3. "errmsg": "ok",
  4. "matched": 1,
  5. "modified": 1,
  6. "id": ""
  7. }

请求数据示例3: 更新替换一条记录

  1. {
  2. "env":"test2-4a89da",
  3. "query": "db.collection(\"geo\").doc(\"be62d9c4-43ec-4dc6-8ca1-30b206eeed24\").set({data: {
  4. description: \"set\",
  5. done: true
  6. }})"
  7. }

返回数据示例3: 更新替换一条记录

  1. {
  2. "errcode": 0,
  3. "errmsg": "ok",
  4. "matched": 0,
  5. "modified": 0,
  6. "id": "be62d9c4-43ec-4dc6-8ca1-30b206eeed24"
  7. }

数据库操作语句说明

数据库操作语句语法与数据库 API相同