文档中心 > 店铺动态卡片-开发指引

一、功能描述


查找集合中符合条件的记录。


对于数据量较大集合,查询务必添加正确的索引,数据查询数据库超时时间为6秒,请特别注意。


二、方法名


collection.find


三、入参


字段名

类型

必选

默认值

说明

filter

object

-

过滤条件

options.projection

object

-

查询后过滤的字段

options.sort

object

-

排序规则, key是field名字,value是1或-1

options.skip

number

-

跳过的文档数量

options.limit

number

-

查询的文档数量限制


说明:排序规则


形式如下:

sort({
    <字段名1>: <排序规则>,
    <字段名2>: <排序规则>,
})


排序规则: 1代表升序排列, -1代表降序排列。当多个字段排序时,严格按照sort语句传入字段名的先后顺序进行排序。例如:


db.collection('awards').find(
        {}, 
        {  
            sort: {
               age: -1,
                score: -1
            },
            limit: 10,  
        }
    )


上面的代码先根据age降序排列,然后再根据score降序排列。


四、出参


返回一个Promise, resolve结果为数组。


五、云函数调用示例(NodeJS)


exports.main = async function(context) {
    const cloud = context.cloud; 
    const result = await cloud.db.collection('users').find(
        {  
            age: {$gt: 18} 
        }, 
        {  
            projection: {name: 1},  
            sort: {_id: 1},  
            limit: 10,  
            skip: 10, 
        }
    )
    return result;
}


六、客户端调用示例


(端上调用,缺乏上下文参数,不推荐)


FAQ

关于此文档暂时还没有FAQ
返回
顶部