查询文档数量

最近更新时间:2025-02-24 19:45:02

我的收藏

接口定义

count() 接口查询集合中文档数量。
public BaseRes count(String database, String collection, CountQueryParam countQueryParam)

使用示例

BaseRes res = client.count(
"db-test",
"book-vector",
CountQueryParam.newBuilder()
.withFilter("bookName=\\"三国演义\\"")
.build());
System.out.println("count document: "+ res.getCount());

入参描述

参数
是否必选
参数含义
参数配置
database
指定检索的数据库名。
Database 命名要求如下:
只能使用英文字母,数字,下划线_、中划线-,并以英文字母开头。
长度要求:[1,128]。
collection
指定检索的集合名。
Collection 命名要求如下:
只能使用英文字母,数字,下划线_、中划线-,并以英文字母开头。
长度要求:[1,128]。
CountQueryParam
使用创建 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 类型表达式
.withFilter("bookInfo.bookName=\\"三国演义\\"")
<value>:表示要匹配的值。
示例:new Filter("author=\\"jerry\\"").and("page>20")

出参描述

检索结果,如下所示。
count document: 3
参数名
参数含义
count
集合中的文档数量。