Collection

Collection是unicloud数据的指定表集合
获取集合Collection示例如下

const db = uniCloud.database();
// 获取 `user` 集合的引用
const collection = db.collection('user');

集合 Collection

通过 db.collection(name) 可以获取指定集合的引用，在集合上可以进行以下操作

类型	接口	说明
写	add	新增记录（触发请求）
计数	count	获取符合条件的记录条数
读	get	获取集合中的记录，如果有使用 where 语句定义查询条件，则会返回匹配结果集 (触发请求)
引用	doc	获取对该集合中指定 id 的记录的引用
查询条件	where	通过指定条件筛选出匹配的记录，可搭配查询指令（eq, gt, in, …）使用
-	skip	跳过指定数量的文档，常用于分页，传入 offset
-	orderBy	排序方式
-	limit	返回的结果集(文档数量)的限制，有默认值和上限值
-	field	指定需要返回的字段

查询及更新指令用于在 where 中指定字段需满足的条件，指令可通过 db.command 对象取得。

准备资料

在写collection示例前,我得先介绍一下该准备的环境,当然如果你看过前面的章节你也可以跳过这段,

一个unicloud 云数据库并且有users表

一个关联了这个数据库的uniapp项目

如果没有的话,建议看一下本专栏的其他文章

add 写

在cloudfunctions目录上右键新建addUser函数
add方法示例将在本云函数代码文件中书写

add 语法规则

 collection.add(data)

tips:

• 目前云服务商为阿里云时，若集合不存在，调用add方法会自动创建集合。后续可能调整此行为，此方式创建的集合不带索引、表结构，请勿依赖此方式创建集合。

参数	类型	必填	说明
data	object	array	是

add()函数有返回值,当插入数据一条时
返回的插入这条记录的_id
当插入多条数据时,反回的是由_id组成的数组

示例代码如下

云函数代码

'use strict';
// 获取集合的引用
const db = uniCloud.database()
exports.main = async (event, context) => {
	const result=await db.collection('user').add(event)
	//返回数据给客户端
	return result
};

页面代码

<template>
	<button @click="getUniCloudData">add示例</button>
</template>

<script setup>
	const getUniCloudData=async ()=>{
		const result = await uniCloud.callFunction({name:'addUser',data:{name:'张三',age:38,email:'zhangshan@email.com',intro:'一个普普通通的律师'}})
		console.log(result)
	}
</script>
	
<style>
</style>

页面显示’

输出如下

查看unicloud控制台,可以看到,数据新增成功

新增多条数据,不需要改动云函数代码,只需要在调用时将data参数改为数组对象即可
示例代码

<template>
	<button @click="getUniCloudData">add示例</button>
</template>

<script setup>
	const getUniCloudData=async ()=>{
		const result = await uniCloud.callFunction({name:'addUser',data:[
			{name:'ggbond',age:38,email:'ggbond@email.com',intro:'一只猪'},
			{name:'猪八戒',age:38,email:'zhubajie@email.com',intro:'一直吃素的猪'},
			{name:'佩奇',age:38,email:'peiqi@email.com',intro:'一只吹风机'},
		]})
		console.log(result)
	}
</script>
	
<style>
</style>

输出结果如下

数据内如下

count 计数

count()语法规则

任何查询的集合.count()

示例代码如下
创建一个countDemo云函数并在里面书写如下代码
即查询users表内有多少条数据

'use strict';
const db = uniCloud.database()
exports.main = async (event, context) => {
	const result = await db.collection('users').count()
	return result
};

页面代码如下

输出结果如下

get 读

get()函数用于获取集合中的记录，如果有使用 where 语句定义查询条件，则会返回匹配结果集 (触发请求)
这里先简单的介绍get函数,where单独篇章介绍

语法

db.collection('users').get()

示例代码如下图

云函数代码

页面调用云函数代码

示例效果如下
将所有云数据库users表内的数据都拿回来了

doc 引用

doc()获取对该集合中指定 id 的记录的引用
语法如下
doc不能单独使用需要搭配其他的函数使用
比如搭配get()函数,获取数据库内指定表内的_id值的数据
示例如下
获取unicloud数据库内的ggbond的数据,ggbond数据_id值为如下

示例代码如下

云函数代码

'use strict';
const db = uniCloud.database()
exports.main = async (event, context) => {
	const result = await db.collection('users').doc('65eaa82b358ba96e9f0fe233').get()
	return result
};

页面引用云函数代码

const getUserInfo = async _=>{
		const result = await uniCloud.callFunction({name:'docKeyData'})
	}

输出如下

where 条件查询

where 语法太多,这里不做展开

skip 跳过

skip跳过指定数量的文档，常用于分页，传入 offset

示例如下
跳过如下数据库的前2条数据

示例代码如下

云函数代码

'use strict';
exports.main = async (event, context) => {
	const result = await uniCloud.database().collection('users').skip(2).get()
	//返回数据给客户端
	return result
};

页面引用云函数代码

const skipFun=async _=>{
	const result =await uniCloud.callFunction({name:'skip'})
	console.log(result)
}

输出如下
可以看出,跳过了签名两条

orderBy 排序

orderBy排序方式

tips:

• 排序字段存在多个重复的值时排序后的分页结果，可能会出现某条记录在上一页出现又在下一页出现的情况。这时候可以通过指定额外的排序条件比如.orderBy(“name”, “asc”).orderBy(“_id”, “asc”)来规避这种情况。

语法如下

collection.orderBy(field, orderType)

参数	类型	必填	说明
field	string	是	排序的字段
orderType	string	是	排序的顺序，升序(asc) 或 降序(desc)

对查询结果,按照年龄降序
示例代码如下

云函数代码

'use strict';
exports.main = async (event, context) => {
	const result = await uniCloud.database().collection('users').orderBy('age','desc').get()
	return result
};

页面引用云函数代码

const orderBy = async _=>{
	const result = await uniCloud.callFunction({name:'orderBy'})
	console.log(result)
}

输出结果如下

limit 限制返回

limit 返回的结果集(文档数量)的限制，有默认值和上限值
语法

collection.limit(8) //不输入则默认10

限制数据库查询返回三条
示例代码如下

云函数代码

'use strict';
exports.main = async (event, context) => {
	const result = await uniCloud.database().collection().limit(3).get()
	return result
};

页面引用云函数代码

const limit = async _=>{
	const result = await uniCloud.callFunction({name:'limit'})
	console.log(result)
}

输出如下

只返回了三条

field 返回指定字段

field 从查询结果中，过滤掉不需要的字段，或者指定要返回的字段。
语法如下

collection.field()

参数	类型	必填	说明
-	object	是	过滤字段对象，包含字段名和策略，不返回传false，返回传true

tips:

• field内指定是否返回某字段时，不可混用true/false。即{‘a’: true, ‘b’: false}是一种错误的参数格式
• 只有使用{ ‘_id’: false }明确指定不要返回_id时才会不返回_id字段，否则_id字段一定会返回。

查询unicloud数据库users表,只返回name字段

示例代码如下

云函数代码

'use strict';
exports.main = async (event, context) => {
	const result = await uniCloud.database().collection('users').field('name').get()
	return result
};

页面引用代码

const field =async _=>{
	const result = await uniCloud.callFunction({name:'field'})
	console.log(result)
}

输出如下