count

最近更新时间:2025-07-01 10:19:43

我的收藏
本接口(/document/count)用于查询集合中文档的数量。

Method 与 URL

POST https://{实例访问 IP 地址}:{实例网络端口}/document/count

请求示例

curl -i -X POST \\
-H 'Content-Type: application/json' \\
-H 'Authorization: Bearer account=root&api_key=A5VOgsMpGWJhUI0WmUbY********************' \\
http://10.0.X.X:80/document/count \\
-d '{
"database": "db-test",
"collection": "book-emb",
"query": {
"filter": "bookName in (\\"三国演义\\",\\"西游记\\")"
}
}'

请求参数

参数名称
参数含义
子参数
是否必选
配置方法及要求
database
指定要更新文档的 Database 名称。
-
使用 /database/list 获取集群中的数据库列表,复制需更新数据的集合所属的数据库名。
collection
指定要更新文档的 Collection 名称。
-
使用 /collection/list 获取指定数据库名下的 Collection 列表,复制需更新数据的集合名。
query
设置查询条件检索需更新的文档
filter
表示要更新的文档的所有 ID,支持批量查询,数组元素范围[1,20]。使用创建 Collection 指定的 Filter 索引的字段设置查询过滤表达式。Filter 的表达式格式为 '<field_name><operator><value>',多个表达式之间支持 and(与)、or(或)、not(非)关系。具体信息,请参见 Filter 条件表达式。其中
<field_name>:表示要过滤的字段名。
<operator>:表示要使用的运算符。
string :匹配单个字符串值(=)、排除单个字符串值(!=)、匹配任意一个字符串值(in)、排除所有字符串值(not in)。其对应的 Value 必须使用英文双引号括起来。
uint64:大于(>)、大于等于(>=)、等于(=)、小于(<)、小于等于(<=)、不等于(!=)。例如:expired_time > 1623388524。
array:数组类型,包含数组元素之一(include)、排除数组元素之一(exclude)、全包含数组元素(include all)。例如,name include (\\"Bob\\", \\"Jack\\")。
json:json 类型的 Filter 表达式语法和 json 字段的键值类型保持一致。若访问 Json 对象中的键,使用点(.)符号连接。例如:Json 类型的字段 bookInfo ,其键 bookName 的 Filter 表达式如下所示。更多信息,请参见Json 类型表达式
"filter": "bookInfo.bookName in (\\"三国演义\\",\\"西游记\\")"
<value>:表示要匹配的值。

响应消息

{
"code": 0,
"msg": "Operation success",
"count": 2
}
参数名
参数含义
count
集合中的文档数量。