「SequoiaDB巨杉数据库」find()概述2

参数

• cond ( Object， 选填 )

  记录匹配条件。为空时，查询所有记录；不为空时，查询符合条件记录。如：{"age":{"$gt":30}}。关于匹配条件的使用，可参考匹配符。

• sel ( Object， 选填 )

  查询返回记录的字段名。为空时，返回记录的所有字段；如果指定的字段名记录中不存在，则按用户设定的内容原样返回。如：{"name":"","age":"","addr":""}。

• hint ( Object， 选填 )

  指定查询使用索引的情况。

  • 不指定hint：查询是否使用索引及使用哪个索引将由数据库决定；
  • hint为{"":null}：查询走表扫描；
  • hint为单个索引：如：{"":"myIdx"}，表示查询将使用当前集合中名字为"myIdx"的索引进行；
  • hint为多个索引：如：{"1":"idx1","2":"idx2","3":"idx3"}， 表示查询将使用上述三个索引之一进行。 具体使用哪一个，由数据库评估决定。

• skipNum ( Int32， 选填 )

  自定义从结果集哪条记录开始返回。默认值为0，表示从第一条记录开始返回。

• retNum ( Int32， 选填 )

  自定义返回结果集的记录条数。默认值为-1，表示返回从skipNum位置开始到结果集结束位置的所有记录。

• sort ( Object， 选填 )

  指定结果集按指定字段名排序的情况。字段名的值为1或者-1，如：{"name":1,"age":-1}。

  • 不指定sort：表示不对结果集做排序；
  • 字段名的值为1：表示按该字段名升序排序；
  • 字段名的值为-1：表示按该字段名降序排序。

• SdbQueryOption ( Object， 选填 )

  使用一个对象来指定记录查询参数。使用方法可参考SdbQueryOption。

注意：

• sel参数为Object类型，其字段内容为空字符串即可，数据库只关心其字段名。

• hint参数为Object类型，其字段名可以为任意不重复的字符串，数据库只关心起字段内容。

返回值

成功：返回DBCursor对象。

失败：抛出异常。

点击巨杉数据库文档中心了解更多信息