文档中心
v3.4

SequoiaDB 简介

安装部署

数据库实例

分布式引擎

SAC 管控中心

参考手册

常见问题及解答(FAQ)

版本信息

count()

名称

count - 统计当前集合符合条件的记录总数

语法

db.collectionspace.collection.count([cond])

db.collectionspace.collection.count([cond]).hint([hint])

类别

SdbCollection

描述

该函数用于统计当前集合符合条件的记录总数,可通过 hint 指定查询使用的索引。

参数

参数 condhint 的用法与 find() 的相同。

返回值

函数执行成功时,将返回一个 CLCount 类型的对象。通过该对象获取符合条件的记录总数。

函数执行失败时,将抛异常并输出错误信息。

错误

count()函数常见异常如下:

错误码 错误类型 可能发生的原因 解决办法
-6 SDB_INVALIDARG 参数错误 查看参数是否填写正确
-34 SDB_DMS_CS_NOTEXIST 集合空间不存在 检查集合空间是否存在
-23 SDB_DMS_NOTEXIST 集合不存在 检查集合是否存在

当异常抛出时,可以通过 getLastErrMsg() 获取错误信息或通过 getLastError() 获取错误码。更多错误处理可以参考常见错误处理指南

版本

v1.0 及以上版本

示例

  • 统计集合 sample.employee 所有的记录数,即不指定参数 cond

    db.sample.employee.count()
  • 统计符合条件 name 字段的值为"Tom"且 age 字段的值大于 25 的记录数

    > db.sample.employee.count({name: "Tom", age: {$gt: 25}})
  • 统计符合条件 name 字段的值为"Tom"且 age 字段的值大于 25 的记录数,使用索引 nameIdx

    > db.sample.employee.count({name: "Tom", age: {$gt: 25}}).hint({"": "nameIdx"})
回到顶部