小程序·云开发提供了丰富的数据库操作 api,此处是数据库 server 端的 api 参考文档,可用于云函数运行环境。
server 端的 api 与小程序端基本保持一致,有如下不同:
数据库 api 都是懒执行的,这意味着只有真实需要网络请求的 api 调用才会发起网络请求,其余如获取数据库、集合、记录的引用、在集合上构造查询条件等都是不会触发网络请求的。触发网络请求的 api 有如下几个:
api | 说明 |
---|---|
get | 获取集合 / 记录数据 |
add | 在集合上新增记录 |
update | 更新集合 / 记录数据 |
set | 替换更新一个记录 |
remove | 删除记录 |
count | 统计查询语句对应的记录条数 |
获取引用的 api 有如下几个:
api | 说明 |
---|---|
database | 获取数据库引用,返回 database 对象 |
collection | 获取集合引用,返回 collection 对象 |
doc | 获取对一个记录的引用,返回 document 对象 |
在数据库 (database) 对象上有如下字段:
字段 | 说明 |
---|---|
command | 获取数据库查询及更新指令,返回 command |
serverdate | 构造服务端时间 |
geo | 获取地理位置操作对象,返回 geo 对象 |
createcollection | 创建一个集合 |
在集合 (collection) 对象上有如下 api:
api | 说明 |
---|---|
doc | 获取对一个记录的引用,返回 document 对象 |
add | 在集合上新增记录 |
update | 更新数据 |
where | 构建一个在当前集合上的查询条件,返回 query,查询条件中可使用查询指令 |
remove | 删除匹配相应筛选条件的记录 |
orderby | 指定查询数据的排序方式 |
limit | 指定返回数据的数量上限 |
skip | 指定查询时从命中的记录列表中的第几项之后开始返回 |
field | 指定返回结果中每条记录应包含的字段 |
在记录 (document) 对象上有如下 api:
api | 说明 |
---|---|
get | 获取记录数据 |
update | 局部更新数据 |
set | 替换更新记录 |
remove | 删除记录 |
field | 指定返回结果中记录应包含的字段 |
command (db.command) 对象上有如下查询指令:
api | 说明 |
---|---|
eq | 字段是否等于指定值 |
neq | 字段是否不等于指定值 |
lt | 字段是否小于指定值 |
lte | 字段是否小于或等于指定值 |
gt | 字段是否大于指定值 |
gte | 字段是否大于或等于指定值 |
in | 字段值是否在指定数组中 |
nin | 字段值是否不在指定数组中 |
and | 条件与,表示需同时满足另一个条件 |
or | 条件或,表示如果满足另一个条件也匹配 |
command (db.command) 对象上有如下更新指令:
api | 说明 |
---|---|
set | 设置字段为指定值 |
remove | 删除字段 |
inc | 原子自增字段值 |
mul | 原子自乘字段值 |
push | 如字段值为数组,往数组尾部增加指定值 |
pop | 如字段值为数组,从数组尾部删除一个元素 |
shift | 如字段值为数组,从数组头部删除一个元素 |
unshift | 如字段值为数组,往数组头部增加指定值 |
api reject 时返回的 error 对象均含以下两个字段:
字段 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |