数据表

数据存储是知晓云提供的核心功能之一，借助它，你可以省去自己搭建数据库，维护数据库及优化数据库查询等麻烦操作。通过以下操作，便可以向在控制台创建的数据表添加一条记录：

要操作数据表，需要借助 TableObject 对象，每个 TableObject 实例对应一张数据表，通过 TableObject 实例，你可以对数据表进行增删改查的操作。

当我们需要创建一行新的数据时，使用 create() 方法, 该方法无需传入参数，create() 方法 返回值为 wx.BaaS.TableRecord 对象。

通过 TableRecord 实例的 set 和 save 方法，可以完成数据行的创建。

SDK 1.2.0 以下（不包含 1.2.0 ）版本仅支持通过数据表 ID 实例化 TableObject，如操作数据表名为 10 的数据表，可进行如下实例化：new wx.BaaS.TableObject(10)

  1. let tableName = 'product'
  2. // 通过 `tableName` 实例化一个 `TableObject` 对象，操作该对象即相当于操作对应的数据表
  3. let Product = new wx.BaaS.TableObject(tableName)
  4. // 本地创建一条空记录
  5. let product = Product.create() // product 为 TableRecord 实例
  7. let apple = {
  8.   name: 'apple',
  9.   price: 1,
  10.   desc: ['good'],
  11.   amount: 0
  12. }
  14. // 为上面创建的空记录赋值，并保存到服务器，save() 方法返回一个 Promise 对象
  15. product.set(apple).save().then(res => { 
  16.   console.log(res)
  17. })

返回示例

res 结构如下：

  1. {
  2.   "statusCode": 201,
  3.   "data": {
  4.       "_id": "59a3c2b5afb7766a5ec6e84e",
  5.       "amount": 0,
  6.       "created_at": 1503904437,
  7.       "created_by": 36395395,
  8.       "desc": ["good"],
  9.       "id": "59a3c2b5afb7766a5ec6e84e",
  10.       "name": "apple",
  11.       "price": 1.0,
  12.       "read_perm": ["user:*"],
  13.       "updated_at": 1503904437,
  14.       "write_perm": ["user:*"]
  15.   }
  16. }

数据表支持多种类型的数据，包括数组类型，时间日期类型，geojson 类型和文件类型，并且支持原子操作等高级功能，如下，既是对产品数量的进行原子性减 1 操作：

通过 TableObject 实例上的 getWithoutData() 方法，我们得到一个 TableRecord 实例，该实例指向了 id 为 recordID 的数据行，接下来的对该 TableRecord 实例的操作会修改数据表中对应数据行的内容。

  1. let recordID = 'xxxxxxxxxx' // 数据行 id
  2. let product = Product.getWithoutData(recordID)  // product 为 TableRecord 实例，指向了线上 id 为 recordID 的数据行
  3. // 执行原子性减 1
  4. product.incrementBy('amount', -1)  // 调用 TableRecord 实例的 incrementBy 方法
  5. product.update().then(res => {  // 调用 TableRecord 实例的 update 方法，保存对数据行的修改，update 返回值为一个 Promise 对象
  6.   console.log(res)
  7. })

返回示例

res 结构如下：

  1. {
  2.   "statusCode": 200,
  3.   "data": {
  4.       "_id": "59a3c2b5afb7766a5ec6e84e",
  5.       "amount": -1,
  6.       "created_at": 1503904437,
  7.       "created_by": 36395395,
  8.       "desc": ["good"],
  9.       "id": "59a3c2b5afb7766a5ec6e84e",
  10.       "name": "apple",
  11.       "price": 1.0,
  12.       "read_perm": ["user:*"],
  13.       "updated_at": 1503904437,
  14.       "write_perm": ["user:*"]
  15.   }
  16. }

同时，SDK 提供了多种复杂查询操作，包括正则匹配查询，数组查询，甚至是与或的组合查询，如下是正则匹配查询的使用：

使用高级查询我们需要创建一个 wx.BaaS.Query 对象实例，通过在 Query 实例上调用 matches、compare 等方法来设置查询条件，

然后调用 TableObject 实例的 setQuery 方法，来设置查询条件。

最后调用 TableObject 实例的 find 方法，来发起查询。find 方法返回值为一个 Promise。

  1. // 假设 product 表有一个字段为 product_id ，其中数据的格式形如 '112233'
  2. let Product = new wx.BaaS.TableObject(tableName)
  3. var query = new wx.BaaS.Query()
  5. // 查找产品 ID 以 11 开头，以 33 结尾的产品
  6. regx = /^11\d+33$/
  8. query.matches('product_id', regx)
  9. Product.setQuery(query).find().then(res => { // find 方法返回值为一个 Promise
  10.   console.log(res)
  11. })

返回示例

res 结构如下

  1. {
  2.   "statusCode": 200,
  3.   "data": {
  4.     "meta": {
  5.       "limit": 20,
  6.       "next": null,
  7.       "offset": 0,
  8.       "previous": null,
  9.       "total_count": 2
  10.     },
  11.     "objects": [
  12.       {
  13.         "created_at": 1487053098,
  14.         "id": "59a3c2b5afb7766a5ec6e84f",
  15.         "product_id": "112233"
  16.       },
  17.       {
  18.         "created_at": 1487053095,
  19.         "id": "59a3c2b5afb7766a5ec6e84e",
  20.         "product_id": "112333"
  21.       }
  22.     ]
  23.   }
  24. }

阅读以下章节，了解更多数据表操作接口：