删除记录项

删除本记录项

通过调用 Record 实例的 delete 方法将该记录项删除。

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

结果返回

名称类型说明
successBool是否删除成功
errorNSError错误信息,参考错误处理和错误码

批量删除数据项

可以通过设置查询条件,将符合条件的数据进行批量删除操作,同时可以根据需要是否设置触发触发器。下面示例代码删除所有 colorbrown 的记录。

其中:

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

  • limit:设置一次删除符合条件记录的数量

  • offset:待删除记录的起始偏移量

  1. let whereArgs = Where.contains("color", value: "brown")
  2. let query = Query()
  3. query.where = whereArgs
  4. query.limit = 10
  5. query.offset = 0
  6. let options = ["enable_trigger": true]
  7. table.delete(query: query, options: completion: { (result, error) in
  8. })
  1. BaaSWhere *where = [BaaSWhere contains:@"color" value:@"brown"];
  2. BaaSQuery *query = [[BaaSQuery alloc] init];
  3. query.where = where;
  4. query.limit = 10;
  5. [query.offset = 0;
  6. NSDictionary *options = @{@"enable_trigger": @true};
  7. [table deleteWithQuery:query options:options completion:^(NSDictionary<NSString *,id> * _Nullable result, NSError * _Nullable error) {
  8. }];

参数说明

参数名类型必填说明
queryQueryN查询条件,详见数据表 - 查询
optionsDictionaryN批量操作选项 ,目前支持支持 enable_trigger, true 为触发触发器

返回结果

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

返回示例

  1. {
  2. "succeed": 8,
  3. "total_count": 10,
  4. "offset": 0,
  5. "limit": 10,
  6. "next": null
  7. }

参数说明

参数类型说明
succeedInt成功创建记录数
total_countInt总的删除记录数
offsetInt与传入参数 offset 一致
limitInt与传入参数 limit 一致
nextString下一页待删除记录地址,若值为 null,表示已删除完成

常见错误码

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

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