删除记录项

删除本记录项

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

{% tabs swift1=”Swift”, oc1=”Objective-C” %} {% content “swift1” %}

  1. let options = [RecordOptionKey.enableTrigger: true]
  2. record.delete(options: options, completion { (success, error) in
  4. })

{% content “oc1” %}

  1. NSDictionary *options = @{RecordOptionKey.enableTrigger: @YES};
  2. [_record deleteWithOptions:options completion:^(BOOL success, NSError * _Nullable error) {
  4. }];

{% endtabs %}

参数说明

参数名 类型 说明 必填
options [RecordOptionKey: Any] 操作选项，参考 RecordOptionKey N

结果返回

名称 类型 说明
success Bool 是否删除成功
error NSError 错误信息，参考错误处理和错误码

批量删除数据项

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

其中：

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

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

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

{% tabs swift2=”Swift”, oc2=”Objective-C” %} {% content “swift2” %}

  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
  9. })

{% content “oc2” %}

  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) {
  9. }];

{% endtabs %}

参数说明

参数名 类型 必填 说明
query Query N 查询条件，详见数据表 - 查询
options [RecordOptionKey: Any] 操作选项，参考 RecordOptionKey N

返回结果

名称 类型 说明
result Dictionary 删除的数据结果
error NSError 错误信息，参考错误处理和错误码

返回示例

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

参数说明

参数 类型 说明
succeed Int 成功创建记录数
total_count Int 总的删除记录数
offset Int 与传入参数 offset 一致
limit Int 与传入参数 limit 一致
next String 下一页待删除记录地址，若值为 null，表示已删除完成

常见错误码

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

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