# 数据库更新记录

通过本接口可以数据库更新记录，使用过程中如遇到问题，可在开放平台服务商专区发帖交流。

# 请求地址

POST https://api.weixin.qq.com/componenttcb/dbrecord?access_token=ACCESS_TOKEN&action=update

# 请求参数

属性	类型	必填	说明
access_token	string	是	第三方接口调用令牌component_access_token
action	string	是	填update
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相同