更新数据

更新单条数据

接口

PUT /hserve/v2.2/table/:table_name/record/:record_id/

其中 :table_name 需替换为你的数据表名称，record_id 需替换为你的记录 ID

参数说明

参数	类型	必填	说明
$unset	object	N	删除字段
$set	object	Y	更新字段

info

• 对同一字段进行多次 set 操作，后面的数据会覆盖掉前面的数据

• 不可同时用 set 与 unset 操作同一字段，否则会报 605 错误

• 数据要与预先在知晓云平台设定的数据类型一致

• 如果没有指定为 $unset 更新，则默认为 $set 更新

• 若更新数据中包含 created_by, created_at, updated_at 这几个字段，则最终更新完成的数据中这几个字段将以更新数据中设置的字段值为准。

请求示例

更新表 test_table 中 id 为 5cbe89e7f1ec740af442a1fa 的记录，将记录的 nickname 更新为 cool, 删除记录的 gender 字段

curl -X PUT \
  -H "X-Hydrogen-Client-ID: [[client_id]]" \
  -H "Authorization: Hydrogen-r1 {{AccessToken}}" \
  -H "Content-Type: application/json" \
  -d '{"$set": {"nickname": "cool"}, "$unset": {"gender": ""}}' \
  https://{{服务器域名}}/hserve/v2.2/table/test_table/record/5cbe89e7f1ec740af442a1fa/

返回参数说明

参数	类型	说明
id	string	id, 唯一标识
created_at	integer	创建时间
updated_at	integer	更新时间
created_by	integer	创建者 id
read_perm	array	读权限
write_perm	array	写权限

返回示例

{
    "_id": "5cbe89e7f1ec740af442a1fa",
    "_prefetched_objects_cache": {},
    "created_at": 1555990980,
    "created_by": 37967230792046,
    "id": "5cbe89e7f1ec740af442a1fa",
    "read_perm": [
        "user:*"
    ],
    "nickname": "cool",
    "updated_at": 1556006931,
    "write_perm": [
        "user:37967230792046"
    ]
}

状态码说明

• 200 更新成功

更新 pointer 类型数据

接口

PUT /hserve/v2.2/table/:table_name/record/:record_id/

其中 :table_name 需替换为你的数据表名称，record_id 需替换为你的记录 ID

请求示例

假设有 product 表, product 表部分字段如下:

字段名	字段类型	说明
user	pointer	指向了 _userprofile 表

现在需要更新 product 表中 id 为 1bdfaf068asd123123asd 的数据行, 将它的 user 字段指向 _userprofile 表中 id 为 5cbecc548b155c0b6d1da762 的记录

curl -X PUT \
  -H "X-Hydrogen-Client-ID: [[client_id]]" \
  -H "Authorization: Hydrogen-r1 {{AccessToken}}" \
  -H "Content-Type: application/json" \
  -d '{"user":"5cbecc548b155c0b6d1da762"}' \
  https://{{服务器域名}}/hserve/v2.2/table/product/record/1bdfaf068asd123123asd/

返回参数说明

参数	说明
id	id, 唯一标识
created_at	创建时间
updated_at	更新时间
created_by	创建者 id
read_perm	读权限
write_perm	写权限

返回示例

{
    "_id": "1bdfaf068asd123123asd",
    "_prefetched_objects_cache": {},
    "created_at": 1555990980,
    "created_by": 37967230792046,
    "id": "1bdfaf068asd123123asd",
    "read_perm": [
        "user:*"
    ],
    "user": {
        "_table": "_userprofile",
        "id": "5cbecc548b155c0b6d1da762"
    },
    "updated_at": 1556008061,
    "write_perm": [
        "user:37967230792046"
    ]
}

状态码说明

• 200 更新成功

数据原子性更新

当请求同时对一个数据进行修改时，原子性更新使得冲突和覆盖导致的数据不正确的情况不会出现，目前支持的数据类型是数字类型和数组类型

接口

PUT /hserve/v2.2/table/:table_name/record/:record_id/

其中 :table_name 需替换为你的数据表名称，record_id 需替换为你的记录 ID

参数说明

参数	类型	必填	说明
key	key 字段对应的数据类型	Y	key 应为数据表中定义的字段名

本接口支持以下原子性操作：

(1) incr_by 对数字类型的字段的值进行增减操作

将对象中的价格（price）字段加 1

{
  "price": {
    "$incr_by": 1
  }
}

将对象中的价格（price）字段减 1

{
  "price": {
    "$incr_by": -1
  }
}

(2) append 对数组类型的字段的值追加一个数组

往对象中的 tag 字段追加 「Hello」

{
  "tag": {
    "$append": ["Hello"]
  }
}

(3) append_unique 对数组类型的字段的值追加一个数组，但追加的数组里的数组项，如果已存在于原数组中，则该数组项不会再被追加

往对象中的 tag 字段追加 「Hello」，tag 字段依然为 ["Hello"]

{
  "tag": {
    "$append_unique": ["Hello"]
  }
}

(4) remove 从数组类型的字段的值里，删除包含在指定数组中的数组项

往对象中的 tag 字段删除 「Hello」

{
  "tag": {
    "$remove": ["Hello"]
  }
}

请求示例

curl -X PUT \
  -H "X-Hydrogen-Client-ID: [[client_id]]" \
  -H "Authorization: Hydrogen-r1 {{AccessToken}}" \
  -H "Content-Type: application/json" \
  -d '{"desc": {"$append": ["atomic data"]}, "price": {"$incr_by": -1}}' \
  https://{{服务器域名}}/hserve/v2.2/table/test_table/record/5cbe89e7f1ec740af442a1fa/

返回参数说明

参数	说明
id	id, 唯一标识
created_at	创建时间

返回示例

{
  "created_at": 1487053095,
  "id": "7",
  "name": "fushi",
  "price": 11,
  "desc": ["sweet", "red"],
  "amount": 2
}

按条件批量更新数据

数据更新依赖当前登录用户拥有的该数据的写权限。

接口

PUT /hserve/v2.2/table/:table_name/record/

其中 :table_name 需替换为你的数据表名称，record_id 需替换为你的记录 ID

info

1. 当更新的数据大于 1000 条时，不支持使用触发器，且删除操作是异步执行

2. 如需更新 1000 条以上数据，可指定 enable_trigger 为 0 不触发触发器。

3. 该接口支持通过参数 return_total_count 指定是否返回待更新对象总数，以协助不关心对象总数只关心数据更新结果的开发者提升接口响应速度。同时，从 v2.2 版本开始该接口默认不返回待更新对象总数，欲获取总数的开发者需要显式指定 return_total_count 参数。

参数说明

Query Parameters:

参数	类型	必填	说明
where	object	Y	筛选的条件
limit	integer	N	最多更新数
offset	integer	N	从第几条开始更新
enable_trigger	integer	N	是否使用触发器，1 为使用触发器，0 为不使用
return_total_count	integer	N	返回结果中是否包含 total_count，1 为包含，0 为不包含，默认不包含

• where 可参考查询数据中的使用方式

• limit、offset 的构造可参考分页和排序

请求示例

更新 nickname 为 hgz 的记录, 将 age 加 1

curl -X PUT \
  -H "X-Hydrogen-Client-ID: [[client_id]]" \
  -H "Authorization: Hydrogen-r1 {{AccessToken}}" \
  -H "Content-Type: application/json" \
  -d '{"age": {"$incr_by": 1}}' \
  "https://{{服务器域名}}/hserve/v2.2/table/test_table/record/?where=%7b%22nickname%22%3a%7b%22%24eq%22%3a%22hgz%22%7d%7d"

其中 %7b%22nickname%22%3a%7b%22%24eq%22%3a%22hgz%22%7d%7d 为 {"nickname":{"$eq":"hgz"}} 经过 urlencode 后的结果

info

where 一定要作为 URL 的 Query Parameters 传入

返回参数说明

参数	说明
succeed	成功更新记录数
total_count	where 匹配的记录数，包括无权限操作记录，仅当 return_total_count 为 1 时返回
offset	与传入参数 offset 一致
limit	与传入参数 limit 一致
next	下一次的更新链接，若待更新记录数超过上限，可通过该链接继续更新

返回示例

{
    "succeed": 8,
    "total_count": 10,
    "offset": 0,
    "limit": 10,
    "next": null
}