uniCloud 云函数操作云数据库增删改查
前言
由于官方写的过于仔细，所以特意整理一份简单明了的操作指南，接下来直接进入操作，部分相关介绍可能是借鉴其他博主或官方介绍
一、连接数据库拿到表集合
// 获取数据库对象
const db = uniCloud.database();
// 获取名为 user的表集合
const user_table= db.collection("user");
二、使用步骤
1.写入数据
调用add方法，给某数据表新增数据记录时，如果该数据表不存在，会自动创建该数据表。如下代码给user数据表新增了一条数据，如果user不存在，会自动创建。
'use strict';
// 获取数据库对象
const db = uniCloud.database();
// 云函数
exports.main = async (event, context) => {
// 获取名为 user 的集合
const user_table = db.collection("user");
// 单条插入
let res = await user_table.add({
name: 'Ben',
})
// 批量插入
let res2 = await user_table.add([
{
name: '张同学'
},{
name: '李同学'
},{
name: '王同学'
}
])
return {
code: 200,
msg: '添加成功',
data: res2
}
}
2.引用doc()
collection对象的方法可以增和查数据，删和改不能直接操作，需要collection对象通过doc或get得到指定的记录后再调用remove或update方法进行删改。默认是通过id唯一查询
2.1 修改数据方法一： doc.set()
通过set()方法会覆盖整条数据，如果数据不存在的话会直接创建
// 获取数据库对象，拿到表
const db = uniCloud.database();
const user_table= db.collection("user");
// 将id为12345的数据进行一个覆盖
let res = await user_table.doc('12345').set({
name: "张同学",
})
2.2 修改数据方法二： doc.update()
通过update()方法会进行数据的一个局部更新
// 获取数据库对象，拿到表
const db = uniCloud.database();
const user_table= db.collection("user");
// 将id为12345的张同学修改为新同学
let res = await user_table.doc('12345').update({
name: "新同学",
})
2.3 删除数据： doc.remove()
通过remove()方法进行指定ID删除
// 获取数据库对象，拿到表
const db = uniCloud.database();
const user_table= db.collection("user");
// 获取id为12345的同学，并进行一个删除
user_table.doc('12345').remove().then((res) => {
console.log("删除成功");
})
3.读取数据
3.1 读取全部数据： collection.get()
获取集合中的记录，如果有使用 where 语句定义查询条件，则会返回匹配结果集 (触发请求)
// 获取数据库对象，拿到表
const db = uniCloud.database();
const user_table= db.collection("user");
// 获取user_table所有数据
let res = user_table.get()
rerun {
code: 200,
msg: '查询成功',
data: res
}
3.2 读取筛选数据： collection.where()
设置过滤条件，where 可接收对象作为参数，表示筛选出拥有和传入对象相同的 key-value 的数据
// 获取数据库对象，拿到表
const db = uniCloud.database();
const user_table= db.collection("user");
// 获取user_table中name为张同学的数据
let res = await user_table.where({
name: '张同学'
}).get()
rerun {
code: 200,
msg: '查询成功',
data: res
}
3.3 计数： collection.count()
获取符合条件的记录条数
// 获取数据库对象，拿到表
const db = uniCloud.database();
const user_table= db.collection("user");
// 获取user_table中name为张同学的数据条数
let res = await user_table.where({
name: '张同学',
}).count()
return {
code: 200,
msg: '查询成功',
data: res.total
}
3.4 起始位置： collection.skip()
跳过指定的位置，返回该位置之后的数据，数据量很大的情况下，skip性能会很差，建议使用分页的形式处理
// 获取数据库对象，拿到表
const db = uniCloud.database();
const user_table= db.collection("user");
// 从4四条数据开始读取
let res = await user_table.skip(4).get()
3.5 结果排序： collection.orderBy()
| 项目 | Value | 项目 |
|---|---|---|
| field | string | 排序的字段 |
| orderType | string | 排序的顺序，升序(asc) 或 降序(desc) |
// 获取数据库对象，拿到表
const db = uniCloud.database();
const user_table= db.collection("user");
// name升序查询
let res = await user_table.orderBy("name", "asc").get()
3.6 数据量： collection.limit()
// 获取数据库对象，拿到表
const db = uniCloud.database();
const user_table= db.collection("user");
// 只返回前10条记录
let res = await user_table.limit(10).get()
3.7 限制返回： collection.field()
指定返回字段
// 获取数据库对象，拿到表
const db = uniCloud.database();
const user_table= db.collection("user");
// 只返回name字段、_id字段，其他字段不返回
let res = await collection.field({
'name': true })
三、实战综合案例
1. 分页获取数据
'use strict';
// 获取数据库对象
const db = uniCloud.database();
// 云函数
exports.main = async (event, context) => {
//前端传入的参数：search，pageIndex ，pageSize
let search= event.search? event.search: {
} ;
let pageIndex = event.pageIndex ? event.pageIndex : 1 ; // 页码
let pageSize = event.pageSize ? event.pageSize : 10 ; // 每页展示条数
// 获取总数量
let dataCount = await db.collection(dbName).where(filter).count()
let total = dataCount .total
//计算页数
const totalPage = Math.ceil(total / pageSize)
//如果没有数据了，就返回false
let hasMore ;
if (pageIndex > totalPage || pageIndex == totalPage) {
hasMore = false
} else {
hasMore = true
}
return db.collection(dbName)
.where({
is_on_sale : true})
.skip((pageIndex - 1) * pageSize)
.limit(pageSize)
.get()
.then( res => {
res.hasMore = hasMore ;
res.code = 200
return res ; // 返回json给客户端
})
}