微信小程序云开发 1 - 数据库

微信小程序云开发最重要的有两点：

1、云数据库；

2、云函数；

学会这两点基本就能够进行微信小程序的云开发；

首先，我们先看微信小程序云数据库的基本操作：

1）打开微 信开发者工具，创建一个云开发微信小程序，在创建项目时勾选使用云开发即可；(注意：使用云开发需要使用appId，不能使用测试号，第一次使用云开发的用户需要去开通云开发功能)

2）点击菜单栏的云开发选项，进入云开发控制面板，创建一个新的开发环境，然后点击数据库，在当前环境的数据库中创建一个新的集合lists：

然后点击数据库中的数据权限根配置自己所需的数据库权限；

详细权限可见：权限控制 | 微信开放文档

3）在项目app.js中做如下配置：

// app.js
App({
  onLaunch: function () {
    if (!wx.cloud) {
      console.error('请使用 2.2.3 或以上的基础库以使用云能力');
    } else {
      wx.cloud.init({
        // env 参数说明：
        //   env 参数决定接下来小程序发起的云开发调用（wx.cloud.xxx）会默认请求到哪个云环境的资源
        //   此处请填入环境 ID, 环境 ID 可打开云控制台查看
        //   如不填则使用默认环境（第一个创建的环境）
        env: '所需开发环境的环境ID',
        traceUser: true,
      });
    }
    this.globalData = {};
  }
});

环境ID在这个地方：

4）云数据库的初始化及增删改查：

以如上数据库lists集合为例：

// 初始化数据库
const db = wx.cloud.database();
// 获取 数据库中lists集合
const lists=db.collection('lists');

插入：

db.collection('集合名称').add({
   data:{
       // data 字段表示需新增的 JSON 数据
   }
}).then(res=>{console.log(res))

抛出如下信息即为添加成功：

删除：

db.collection('集合名称').doc('要删除字段的_id').remove().then(res=>{})

抛出如下信息即为删除成功：

更新：

db.collection('集合名称').doc('需要更改的那条数据的_id').update({
  // data 传入需要局部更新的数据
  data: {
  }
}).then(res=>{})

eg:

const _ = db.command
db.collection('lists').doc('0ab5303b6286010904a878280d163117').update({
  data: {
    // 表示指示数据库将age字段自增 1
    age: _.inc(1)
  },
  success: function(res) {
    console.log(res.data)
  }
})

抛出如下信息即为更新成功：

查询：

查询一条记录的数据：

db.collection('集合名称').doc('该条数据的_id').get().then(res => {
  // res.data 包含该记录的数据
  console.log(res.data)
})

根据条件查询：

db.collection('集合名称').where({
  // 查询条件 如:
  age:18
}).get().then(res => {
  // res.data 包含age为18的所有数据
  console.log(res.data)
})

查询集合所有数据：

如果要获取一个集合的数据，比如获取 todos 集合上的所有记录，可以在集合上调用get方法获取，但通常不建议这么使用微信小程序 云开发，在小程序中我们需要尽量避免一次性获取过量的数据，只应获取必要的数据。为了防止误操作以及保护小程序体验，小程序端在获取集合数据时服务器一次默认并且最多返回 20 条记录微信小程序 云开发，云函数端这个数字则是 100。开发者可以通过limit方法指定需要获取的记录数量，但小程序端不能超过 20 条，云函数端不能超过 100 条。

db.collection('集合名称').get().then(res => {
  // res.data 是一个包含集合中有权限访问的所有记录的数据，不超过 20 条
  console.log(res.data)
})

下面是在云函数端获取一个集合所有记录的例子，因为有最多一次取 100 条的限制，因此很可能一个请求无法取出所有数据，需要分批次取：

const cloud = require('wx-server-sdk')
cloud.init()
const db = cloud.database()
const MAX_LIMIT = 100
exports.main = async (event, context) => {
  // 先取出集合记录总数
  const countResult = await db.collection('集合名称').count()
  const total = countResult.total
  // 计算需分几次取
  const batchTimes = Math.ceil(total / 100)
  // 承载所有读操作的 promise 的数组
  const tasks = []
  for (let i = 0; i < batchTimes; i++) {
    const promise = db.collection('集合名称').skip(i * MAX_LIMIT).limit(MAX_LIMIT).get()
    tasks.push(promise)
  }
  // 等待所有
  return (await Promise.all(tasks)).reduce((acc, cur) => {
    return {
      data: acc.data.concat(cur.data),
      errMsg: acc.errMsg,
    }
  })
}