更新数据项

操作步骤

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

示例代码

• Swift
• Objective-C

// 通过 `tableId` 创建数据表实例 
let table = Table(Id: "1236")

// 通过 tablename 创建数据表实例
let table = Table(name: "Book")

// 通过 `tableId` 创建数据表实例
BaaSTable *table = [[BaaSTable alloc] initWithId: @"1236"];

// 通过 tablename 创建数据表实例
BaaSTable *table = [[BaaSTable alloc] initWithName:@"Book"];

参数说明

tableName 和 tableId 二选一

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

• Swift
• Objective-C

let record = table.getWithoutData(recordId: "5c944a10d575a970a9b91c12")

BaaSRecord *record = [table getWithoutDataWithRecordId:@"5c944a10d575a970a9b91c12"];

3.为记录项赋值

有两种类型的赋值操作：

a.一次性赋值：

• Swift
• Objective-C

record.set(["name": "bookname", "color": "red", "price": 19])

[record set:@{@"name": @"bookname", @"color": @"red", @"price": @10}];

参数说明

b.逐个赋值：

• Swift
• Objective-C

record.set("color", value: "red")
record.set("price", value: 10)

[record set:@"color" value:@"red"];
[record set:@"price" value:@10];

c. unset 操作

将某个字段的值清空

• Swift
• Objective-C

book.unset("color")

[record unset:@"color"];

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

• Swift
• Objective-C

let expand = ["pointer"]
let options = [RecordOptionKey.enableTrigger: true]
record.update(expand: expand, options: options, completion: { (success, error) in

})

NSArray *expand = @[@"pointer"];
NSDictionary *options = @{RecordOptionKey.enableTrigger: @YES};
[record updateWithExpand: expand options:options completion: ^(BOOL success, NSError * _Nullable error) {

}];

参数说明

返回结果

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

更新普通数据

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

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

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

更新 file 类型数据

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

更新 geojson 类型数据

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

更新 object 类型数据

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

示例

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

• Swift
• Objective-C

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

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

更新 array 类型数据

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

更新 pointer 类型数据

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

计数器原子性更新

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

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

• Swift
• Objective-C

book.incrementBy("price", value: 10.5)

[book incrementBy:@"price" value:@10.5];

参数说明

更新数据表里 Object 类型中某个字段是 Number 或 Integer 的数据：

例如现有 Book 表中类型为 Object 的字段 info，且具体内容为 {amount: 1}

• Swift
• Objective-C

book.incrementBy("info.amount", value: 0.5)

[book incrementBy:@"info.amount" value:@0.5];

数组原子性更新

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

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

• Swift
• Objective-C

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

[book append:@"recommender" value:@[@"xiaoming"]];

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

参数说明

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

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

• Swift
• Objective-C

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

[book uAppeng:"author" value:@[@"xiaoming", @"xiaohong"]];

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

参数说明

从原数组中删除指定的值

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

• Swift
• Objective-C

book.remove("recommender", value: ["xiaohong"])

[book remove:@"recommender" value:@[@"xiaohong"]];

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

从原数组中删除最后一个元素

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

• Swift
• Objective-C

book.pop("recommender")

[book pop:@"recommender"]];

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

从原数组中删除第一个元素

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

• Swift
• Objective-C

book.shift("recommender")

[book shift:@"recommender"]];

此时，数据表的 recommender 值为 ["xiaohong"]。 参数说明

按条件批量更新数据项

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

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

其中：

• Where 对象的使用请查看 查询数据项 章节

• limit 和 offset 的使用请查看 分页和排序 章节

  实例代码

• Swift
• Objective-C

// 设置查询条件
let whereArgs = Where.compare("price", operator: .lessThan, value: 15)
let query = Query()
query.where = whereArgs

// 设置选项
let options = ["enable_trigger": true]

// 创建一个空记录，用于设置需要更新的操作
let record = table.createRecord()
record.incrementBy("price", value: 1)

// 更新操作
table.update(record: record, query: query, options: options) { (result, error) in

}

// 设置查询条件
BaaSWhere *where = [BaaSWhere compare:@"price" operator:BaaSOperatorLessThan value:@15];
BaaSQuery *query = [[BaaSQuery alloc] init];
query.where = where;

// 设置选项
NSDictionary *options = @{@"enable_trigger": @YES};

// 创建一个空记录，用于设置需要更新的操作
BaaSRecord *record = [_table createRecord];
[record incrementBy:@"price" value:@1];

// 更新操作
[_table updateWithRecord:record query:query options: options completion:^(NSDictionary<NSString *,id> * _Nullable result, NSError * _Nullable error) {

}];

参数说明

返回结果

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

返回示例

 {
  "operation_result": [
    {"success": {"id": "5bfe000ce74243582bf2979f", "updated_at": "1543459089"}},
    {
       "error": {
         "code": 16837,
         "err_msg": "数据更新失败，具体错误信息可联系知晓云微信客服：minsupport3 获取。"
       }
    }
  ],
  "succeed": 8,
  "total_count": 10,
  "offset": 0,
  "limit": 10,
  "next": null
}

返回参数

常见错误码

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