微信小程序云开发（3）— 实现云数据库数据的查询

一、云数据库查询基础

微信小程序云开发提供的云数据库是基于MongoDB的NoSQL数据库，其查询API设计兼顾了易用性与灵活性。要执行查询操作，首先需要获取数据库引用：

const db = wx.cloud.database()
const collection = db.collection('books')

1.1 基础查询方法

get()方法是最简单的查询方式，会返回集合中的所有记录（默认最多20条）：

collection.get().then(res => {
  console.log('查询结果', res.data)
})

实际开发中需要注意：

• 未设置查询条件时返回集合前20条记录
• 单次查询最多返回100条数据（可通过配置调整）
• 异步操作需要使用Promise或async/await处理

1.2 查询结果结构解析

查询返回的对象包含以下关键字段：

{
  "data": [],    // 查询结果数组
  "errMsg": "",  // 错误信息
  "requestID": "" // 本次请求唯一标识
}

二、条件查询详解

2.1 基本条件筛选

使用where()方法构建查询条件：

db.collection('books').where({
  category: 'fiction',
  price: _.gt(50) // 使用数据库指令
}).get()

常用查询指令：

• _.eq 等于
• _.neq 不等于
• _.lt/.lte 小于/小于等于
• _.gt/.gte 大于/大于等于
• _.in/.nin 包含/不包含

2.2 复合查询条件

通过and/or实现复杂逻辑：

// AND条件（默认）
where({
  category: 'fiction',
  stock: _.gt(0)
})
// OR条件
where(_.or([
  {category: 'fiction'},
  {price: _.lt(30)}
]))

2.3 特殊查询技巧

1. 正则表达式查询：

   where({
   title: db.RegExp({
    regexp: '^小程序',
    options: 'i' // 忽略大小写
   })
   })

2. 数组查询：
   ```javascript
   // 数组包含元素
   where({tags: ‘科技’})

// 数组精确匹配
where({tags: _.all([‘科技’,’编程’])})

## 三、高级查询功能
### 3.1 排序与分页
**排序实现**：
```javascript
.orderBy('createTime', 'desc')

分页方案：

1. skip+limit基础分页

   .skip(20).limit(10) // 跳过20条取10条

2. 基于最后记录的优化分页（推荐）：

   const lastDoc = res.data[res.data.length-1]
   .where('createTime', '>', lastDoc.createTime)
   .limit(10)

3.2 字段控制

1. 指定返回字段：

   .field({
   title: true,
   author: true
   })

2. 排除敏感字段：

   .field({
   password: false
   })

3.3 聚合查询

通过aggregate实现复杂统计：

const $ = db.command.aggregate
collection.aggregate()
  .group({
    _id: '$category',
    total: $.sum('$sales')
  })
  .end()

四、性能优化实践

4.1 索引配置建议

1. 为常用查询条件建立索引
2. 复合索引注意字段顺序
3. 通过控制台-数据库-索引管理创建

4.2 查询优化策略

• 避免全表扫描（始终包含条件）
• 限制返回字段数量
• 合理设置limit值（建议不超过100）
• 使用缓存重复查询结果

4.3 实时数据监听

const watcher = collection
  .where({status: 'pending'})
  .watch({
    onChange: console.log,
    onError: console.error
  })
// 适时关闭监听
watcher.close()

五、典型业务场景实现

5.1 商品列表页

// 带筛选、排序、分页的查询
const loadProducts = async (category, sort, page) => {
  return await db.collection('products')
    .where(category ? {category} : {})
    .orderBy(sort.field, sort.order)
    .skip((page-1)*10).limit(10)
    .get()
}

5.2 用户权限验证

// 查询同时验证用户权限
const checkPermission = async (openid, role) => {
  const {data} = await db.collection('users')
    .where({_openid: openid})
    .field({roles: true})
    .get()
  return data[0]?.roles.includes(role)
}

六、常见问题排查

1. 查询无结果：

   • 检查集合权限设置
   • 确认查询条件拼写正确
   • 验证网络连接正常

2. 性能瓶颈：

   • 使用explain分析查询计划
   • 检查是否缺少必要索引
   • 避免客户端循环查询

3. 安全建议：

   • 禁止前端直接接收查询条件对象
   • 敏感字段必须设置权限
   • 批量操作添加频率限制

通过掌握这些查询技术，开发者可以高效实现各类业务场景的数据访问需求。建议结合小程序官方文档和实际项目需求，灵活运用不同查询方法。