删除数据项
SDK 1.1.0 及以上版本
操作步骤
1.通过 tableName
或 tableID
实例化一个 TableObject
对象,操作该对象即相当于操作对应的数据表,这里推荐用 tableName
let MyTableObject = new wx.BaaS.TableObject(tableName)
参数说明
tableName 和 tableID 二选一,不能同时存在
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
tableID | Number | 是 | 数据表的 ID |
tableName | String | 是 | 数据表名(SDK >= 1.2.0) |
返回参数说明
无数据返回
2.指定 recordID 执行删除操作
MyTableObject.delete(recordID)
参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
recordID | String | 是 | 记录 ID |
示例
请求示例
// 删除 tableName 为 'product' 的数据表中 recordID 为 59897882ff650c0477f00485 的数据项
let tableName = 'product'
let recordID = '59897882ff650c0477f00485'
let Product = new wx.BaaS.TableObject(tableName)
Product.delete(recordID).then(res => {
// success
}, err => {
// err
})
返回示例
then 回调中的 res 对象结构如下:
{
"statusCode": 204,
"data": ""
}
err 对象结构请参考错误码和 HError 对象
常见错误:
错误码 err.code | 可能的原因 |
---|---|
404 | 数据行不存在 |
403 | 没有权限删除数据 |
批量删除数据项
SDK 1.4.0 及以上版本支持批量删除数据项。可以通过设置查询条件,将符合条件的数据进行批量删除操作。
其中:
请求示例
let MyTableObject = new wx.BaaS.TableObject(tableName)
let query = new wx.BaaS.Query()
// 设置查询条件(比较、字符串包含、组合等)
//...
MyTableObject.limit(10).offset(0).delete(query).then(res => {
console.log(res)
}, err => {
console.log(err)
})
返回示例
then 回调中的 res 对象结构如下:
{
"statusCode": 200,
"data": {
"succeed": 8, // 成功删除记录数
"total_count": 10, // where 匹配的记录数,包括无权限操作记录
"offset": 0,
"limit": 10,
"next": null // 下一次删除 url,若为 null 则表示全部删除完毕
}
}
err 对象结构请参考错误码和 HError 对象
常见错误:
错误码 err.code | 可能的原因 |
---|---|
404 | 数据行不存在 |
403 | 没有权限删除数据 |
批量删除时不触发触发器
SDK 版本需 >= 1.9.1
// 知晓云后台设置的触发器将不会被触发
MyTableObject.delete(query, {enableTrigger: false}).then(res => {
console.log(res)
}, err => {
//err 为 HError 对象
})
SDK 1.1.0 以下版本
该写法在 sdk v2.0 前仍然有效
wx.BaaS.deleteRecord(OBJECT)
OBJECT 参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
tableID | Number | 是 | 数据表 ID |
recordID | String | 是 | 数据项 ID |
返回参数
无数据返回
请求示例
// 删除 tableID 为 10 的数据表中 recordID 为 59897882ff650c0477f00485 的数据项
let tableID = 10
let recordID = '59897882ff650c0477f00485'
let objects = {
tableID,
recordID
}
wx.BaaS.deleteRecord(objects).then(res => {
// success
}, err => {
// err
})