更新数据项

操作步骤

1.通过 tableNametableId 实例化一个 Table 对象,操作该对象即相当于操作对应的数据表,这里推荐用 tableName

示例代码

  1. // 通过 `tableId` 创建数据表实例
  2. let table = Table(Id: "1236")
  3. // 通过 tablename 创建数据表实例
  4. let table = Table(name: "Book")
  1. // 通过 `tableId` 创建数据表实例
  2. BaaSTable *table = [[BaaSTable alloc] initWithId: @"1236"];
  3. // 通过 tablename 创建数据表实例
  4. BaaSTable *table = [[BaaSTable alloc] initWithName:@"Book"];

参数说明

tableNametableId 二选一

名称类型说明
tableIdString数据表的 Id
tableNameString数据表名

2.通过数据行 id(以下用 recordId 参数名表示) 设置指定数据行

  1. let record = table.getWithoutData(recordId: "5c944a10d575a970a9b91c12")
  1. BaaSRecord *record = [table getWithoutDataWithRecordId:@"5c944a10d575a970a9b91c12"];

3.为记录项赋值

有两种类型的赋值操作:

a.一次性赋值:

  1. record.set(["name": "bookname", "color": "red", "price": 19])
  1. [record set:@{@"name": @"bookname", @"color": @"red", @"price": @10}];

参数说明

名称类型说明
recordDictionary记录信息,key 为字段名称

b.逐个赋值:

  1. record.set("color", value: "red")
  2. record.set("price", value: 10)
  1. [record set:@"color" value:@"red"];
  2. [record set:@"price" value:@10];

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

在通过 set(key:value:)set(record: ) 设置数据时,value 支持的类型包括 IntStringArrayDictionary 等基本数据类型,同时也支持 GeoPointGeoPolygonUserRecord

c. unset 操作

将某个字段的值清空

  1. book.unset("color")
  1. [record unset:@"color"];

4.将数据更新保存到服务器

  1. record.update { (success, error) in
  2. }
  1. [record update:^(BOOL success, NSError * _Nullable error) {
  2. }];

返回结果

名称类型说明
successBool是否新增数据成功
errorNSError错误信息,参考错误处理和错误码

successtrue,本地记录实例 record 的数据将被更新。

通过上面的四个步骤,即完成了一条记录的更新,具体操作阅读以下内容。

更新普通数据

请参考 新增数据项 的添加普通数据

更新日期时间 Date 类型的数据

请参考 新增数据项 的添加日期时间 Date 类型的数据

更新 file 类型数据

请参考 新增数据项 的添加 file 类型数据

更新 geojson 类型数据

详见 地理位置操作 设置地理信息小节

更新 object 类型数据

对象内的属性名只能包含字母、数字和下划线,必须以字母开头,比如 {$ifanr.x: 123}{知晓云: "test"} 是错误的。

示例

Book 表中的 publish_info 为 object 类型,表示出版商,其中有两个字段信息:name 表示出版商名称,location 为出版商地址。

  1. book.updateObject("publish_info", value: ["name": "efg出版社", "location": "广东省广州市天河区五山路 100 号"])
  1. [book updateObject:@"publish_info" value: @{@"name": @"efg出版社", @"location": @"广东省广州市天河区五山路 100 号"}];

更新 array 类型数据

请参考 新增数据项 的添加 array 类型数据

更新 pointer 类型数据

请参考 新增数据项 的添加 pointer 类型数据

计数器原子性更新

对数字类型的字段进行原子性增减操作。当请求同时对一个数据进行增减时,原子性使得冲突和覆盖导致的数据不正确的情况不会出现。

假如 Book 表有一个价钱字段 price,通过原子性增加价钱:

  1. book.incrementBy("price", value: 10.5)
  1. [book incrementBy:@"price" value:@10.5];

参数说明

参数类型必填说明
keyString在数据表中的类型必须是 Number 或 Integer
valueDouble与 key 的类型保持一致

数组原子性更新

将 待插入的数组 加到原数组末尾

假设 Book 表中有一个字段 recommender,表示推荐者,类型是数组,可以有多个推荐者。假如数据表中 recommender["xiaohua", "xiaohong"],现增加一个推荐者:

  1. book.append("recommender", value: ["xiaoming"])
  1. [book append:@"recommender" value:@[@"xiaoming"]];

此时,数据表的 recommender 值为 ["xiaohua", "xiaohong", "xiaoming"]

参数说明

参数类型必填说明
keyString在数据表中的类型必须是 Array
valueArray将该数组的元素插入到数据表中

将 待插入的数组 中不包含在原数组的数据加到原数组末尾

假设 Book 表中有一个字段 recommender,表示推荐者,类型是数组,可以有多个推荐者。假如数据表中 recommender["xiaohua", "xiaohong"],现增加两个推荐者:

  1. book.uAppend(@"author", value: ["xiaoming", "xiaohong"])
  1. [book uAppeng:"author" value:@[@"xiaoming", @"xiaohong"]];

此时,数据表的 recommender 值为 ["xiaohua", "xiaohong", "xiaoming"]

参数说明

参数类型必填说明
keyString在数据表中的类型必须是 Array
valueArray将该数组的元素插入到数据表中

从原数组中删除指定的值

假设 Book 表中有一个字段 recommender,表示推荐者,类型是数组,可以有多个推荐者。假如数据表中 recommender["xiaohua", "xiaohong"],现删除一个推荐者:

  1. book.remove("author", value: ["xiaohong"])
  1. [book remove:@"author" value:@[@"xiaohong"]];

此时,数据表的 recommender 值为 ["xiaohua"]参数说明

参数类型必填说明
keyString在数据表中的类型必须是 Array
valueArray如果元素类型是 geojson、object、file,则只能是 length 为 1 的 Array

按条件批量更新数据项

可以通过设置自定义查询条件 Query,将符合条件的数据进行批量更新操作,同时根据需要是否设置触发触发器。下面示例代码将价格小于 15 的书籍的价格加 1

注意:由于条件查询可能命中非常多的数据,默认情况下,限制为最多更新前 1000 条数据。如需要一次性更新更多数据,请参考下一个小节:不触发触发器的更新,或者通过维护分页来进行。

其中:

实例代码

  1. // 设置查询条件
  2. let whereArgs = Where.compare("price", operator: .lessThan, value: 15)
  3. let query = Query()
  4. query.where = whereArgs
  5. // 设置选项
  6. let options = ["enable_trigger": true]
  7. // 创建一个空记录,用于设置需要更新的操作
  8. let record = table.createRecord()
  9. record.incrementBy("price", value: 1)
  10. // 更新操作
  11. table.update(record: record, query: query, options: options) { (result, error) in
  12. }
  1. // 设置查询条件
  2. BaaSWhere *where = [BaaSWhere compare:@"price" operator:BaaSOperatorLessThan value:@15];
  3. BaaSQuery *query = [[BaaSQuery alloc] init];
  4. query.where = where;
  5. // 设置选项
  6. NSDictionary *options = @{@"enable_trigger": @YES};
  7. // 创建一个空记录,用于设置需要更新的操作
  8. BaaSRecord *record = [_table createRecord];
  9. [record incrementBy:@"price" value:@1];
  10. // 更新操作
  11. [_table updateWithRecord:record query:query options: options completion:^(NSDictionary<NSString *,id> * _Nullable result, NSError * _Nullable error) {
  12. }];

参数说明

参数名类型说明必须
recordRecord需要被更新的信息Y
queryQuery设置扩展字段N
optionsDictionary批量操作选项 ,目前支持支持 enable_trigger, true 为触发触发器N

返回结果

名称类型说明
resultDictionary更新的数据结果
errorNSError错误信息,参考错误处理和错误码

说明 errornil 不说明批量更新数据完全成功,仅代表服务端已收到并处理了这个请求,只有当返回的结果中 operation_result 列表中不存在 error 元素时,才可以认为所有数据均更新成功。

返回示例

  1. {
  2. "operation_result": [
  3. {"success": {"id": "5bfe000ce74243582bf2979f", "updated_at": "1543459089"}},
  4. {
  5. "error": {
  6. "code": 16837,
  7. "err_msg": "数据更新失败,具体错误信息可联系知晓云微信客服:minsupport3 获取。"
  8. }
  9. }
  10. ],
  11. "succeed": 8,
  12. "total_count": 10,
  13. "offset": 0,
  14. "limit": 10,
  15. "next": null
  16. }

返回参数

参数类型说明
succeedInt成功创建记录数
total_countInt总的待创建记录数
offsetInt与传入参数 offset 一致
limitInt与传入参数 limit 一致
nextString下一页待更新记录地址,若值为 null,表示已更新完成
operation_resultInt批量写入每一条数据的结果

常见错误码

  • 201:成功写入
  • 400:非法数据

返回结果默认不包含 totalCount,如需获取该值可以在设置查询条件 Query 时,通过设置 query.returnTotalCount = true 来获取 totalCount。详见获取记录总数