数据表 - 删除数据项

优质
小牛编辑
141浏览
2023-12-01

{% tabs first=”SDK 1.1.0 及以上版本”, second=”SDK 1.1.0 以下版本” %}

{% content “first” %}

SDK 1.1.0 及以上版本

操作步骤

1.通过 tableID 实例化一个 TableObject 对象,操作该对象即相当于操作对应的数据表

let MyTableObject = new wx.BaaS.TableObject(tableID)

参数说明

参数类型必填说明
tableIDNumber数据表 ID

info
SDK 1.2.0 版本已支持通过数据表名实例化 TableObject,如操作数据表名为 ‘product’ 的数据表,可进行如下实例化:new wx.BaaS.TableObject(‘product’)

返回参数说明

无数据返回

2.指定 recordID 执行删除操作

MyTableObject.delete(recordID)

参数说明

参数类型必填说明
recordIDString记录 ID

示例

请求示例

  1. // 删除 tableID 为 10 的数据表中 recordID 为 59897882ff650c0477f00485 的数据项
  2. let tableID = 10
  3. let recordID = '59897882ff650c0477f00485'
  4. let Product = new wx.BaaS.TableObject(tableID)
  5. Product.delete(recordID).then(res => {
  6. // success
  7. }, err => {
  8. // err
  9. })

批量删除数据项

SDK 1.4.0 及以上版本支持批量删除数据项。可以通过设置查询条件,将符合条件的数据进行批量删除操作。

其中:

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

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

请求示例

  1. let MyTableObject = new wx.BaaS.TableObject(tableID)
  2. let query = new wx.BaaS.Query()
  3. // 设置查询条件(比较、字符串包含、组合等)
  4. ...
  5. MyTableObject.limit(10).offset(0).delete(query).then(res => {}, err => {})

返回示例

res.data:

  1. {
  2. "succeed": 8, // 成功删除记录数
  3. "total_count": 10, // where 匹配的记录数,包括无权限操作记录
  4. "offset": 0,
  5. "limit": 10,
  6. "next": null // 下一次删除 url,若为 null 则表示全部删除完毕
  7. }

状态码说明

200 删除成功,400 请求数据非法

注: 由于对数据表的增删改均会触发 trigger 动作,为了防止出现严重消耗系统资源的情况,对数据表进行批量操作的数据条目最多不能超过 1000 条。

{% content “second” %}

SDK 1.1.0 以下版本

info
该写法在 sdk v2.0 前仍然有效

wx.BaaS.deleteRecord(OBJECT)

OBJECT 参数说明

参数类型必填说明
tableIDNumber数据表 ID
recordIDString数据项 ID

返回参数

无数据返回

请求示例

  1. // 删除 tableID 为 10 的数据表中 recordID 为 59897882ff650c0477f00485 的数据项
  2. let tableID = 10
  3. let recordID = '59897882ff650c0477f00485'
  4. let objects = {
  5. tableID,
  6. recordID
  7. }
  8. wx.BaaS.deleteRecord(objects).then(res => {
  9. // success
  10. }, err => {
  11. // err
  12. })

{% endtabs %}