tencent cloud

数据万象

文档数据万象API 文档智能检索 MetaInsight基础检索标量检索表达式语法

标量检索表达式语法

下载
聚焦模式
字号
最后更新时间： 2026-09-08 16:24:29

简介

通过本文您可以了解：
标量检索条件支持的字段（Field）和操作符（Operation），以及字段对应操作符的支持情况。
标量检索条件中支持使用的操作符包括 eq（等于）、gt（大于）、gte（大于等于）、lt（小于）、lte（小于等于）、exist（存在性查询）、match-phrase（模糊查询）和 prefix（前缀查询）。
聚合操作中支持使用的操作符包括 min（最小值）、max（最大值）、average（平均数，类似于 SQL 中的 avg）、sum（求和）、count（计数）、distinct（去重统计行数，类似于 SQL 中的 count(distinct)，去重统计行数的计算结果是个近似值，当去重统计行数小于1万时，计算结果接近精确值，当去重统计行数达到1亿时，计算结果的误差为2%左右）、group（分组计数，当分组较大时可能会存在误差）。
使用自定义标签相关字段（CustomId、CustomLabels）搜索文件时，系统会按照对象标签的 Key-Value 来搜索文件。对象标签的 Key 和 Value 均不区分大小写。例如要搜索包含 Bucket = examplebucket 标签的文件，您需要设置查询条件为 {"Bucket": "examplebucket"}。
下表列出了标量检索条件和聚合操作中支持的字段，以及字段对相应操作符的支持情况。

标量检索条件

Field（字段）
类型
说明
支持的操作符
是否支持排序
COSTaggingCount
Int
COS 自定义标签的数量
eq、gt、gte、lt、lte
是
COSTagging.*
Container
COS 自定义标签。储存您业务在 cos object 上的自定义标签的键名、键值对信息，用于在查询时可以据此为筛选项进行检索
eq、gt、gte、lt、lte、prefix、exist
否
COSUserMeta.*
Container
COS 自定义头部。储存您业务在 cos object 上的键名、键值对信息，用于在查询时可以据此为筛选项进行检索
eq、gt、gte、lt、lte、prefix、exist
否
CreateTime
String
元数据创建时间的时间戳，格式为 RFC3339Nano
eq、gt、gte、lt、lte
是
CustomId
String
该文件的自定义 ID。该文件索引到数据集后，作为该行元数据的属性存储，用于和您的业务系统进行关联、对应。您可以根据业务需求传入该值，例如将某个 URI 关联到您系统内的某个 ID。推荐传入全局唯一的值
eq、gt、gte、lt、lte、prefix
是
CustomLabels.*
Container
文件自定义标签列表。储存您业务自定义的键名、键值对信息，用于在查询时可以据此为筛选项进行检索
eq、gt、gte、lt、lte、prefix、exist
否
ETag
String
Object 生成时会创建相应的 ETag，ETag 用于标识一个 Object 的内容
eq、gt、gte、lt、lte、prefix
是
FileModifiedTime
String
文件最近一次修改时间的时间戳，格式为 RFC3339Nano
eq、gt、gte、lt、lte
是
Filename
String
文件路径
eq、gt、gte、lt、lte、match-phrase、prefix
是
MediaType
String
文件媒体类型
枚举值：
image：图片
other：其他
document：文档
archive：压缩包
audio：音频
video：视频
eq、gt、gte、lt、lte、prefix
是
ObjectACL
String
文件访问权限属性
eq、gt、gte、lt、lte
是
ObjectId
String
对象唯一 ID
eq、gt、gte、lt、lte、prefix
是
ServerSideEncryption
String
加密算法，需要设置 x-cos-server-side-encryption
eq、gt、gte、lt、lte、prefix
是
Size
Int
文件大小，单位为字节
eq、gt、gte、lt、lte
是
UpdateTime
String
元数据修改时间的时间戳，格式为 RFC3339Nano
创建元数据后，如果未更新过元数据，则元数据修改时间的时间戳和元数据创建时间的时间戳相同
eq、gt、gte、lt、lte
是
URI
String
资源标识字段，表示需要建立索引的文件地址
eq、gt、gte、lt、lte、prefix
是

标量检索聚合操作

Field（字段）
类型
说明
支持的操作符
是否支持排序
ContentDisposition
String
指定 Object 被下载时的名称。需要设置 COS Object HTTP 属性 Content-Disposition
count、distinct、group
是
ContentEncoding
String
指定该 Object 被下载时的内容编码格式。需要设置 COS Object HTTP 属性 Content-Encoding
count、distinct、group
是
ContentLanguage
String
Object 内容使用的语言。需要设置 COS Object HTTP 属性 Content-Language
count、distinct、group
是
ContentType
String
文件内容类型（MIME Type）
count、distinct、group
是
COSCRC64
String
文件 CRC64值
count、distinct、group
是
COSStorageClass
String
文件存储空间类型
count、distinct、group
是
COSTagging.*
Container
COS 自定义标签。储存您业务在 cos object 上的自定义标签的键名、键值对信息，用于在查询时可以据此为筛选项进行检索
-
否
COSTaggingCount
Int
COS 自定义标签的数量
min、max、average、sum、count、distinct、group
是
COSUserMeta.*
Container
COS 自定义头部。储存您业务在 cos object 上的键名、键值对信息，用于在查询时可以据此作为筛选项进行检索
-
否
CreateTime
String
元数据创建时间的时间戳，格式为 RFC3339Nano
count、distinct、group
是
CustomId
String
该文件的自定义 ID。该文件索引到数据集后，作为该行元数据的属性存储，用于和您的业务系统进行关联、对应。您可以根据业务需求传入该值，例如将某个 URI 关联到您系统内的某个 ID。推荐传入全局唯一的值
count、distinct、group
是
CustomLabels.*
Container
文件自定义标签列表。储存您业务自定义的键名、键值对信息，用于在查询时可以据此作为筛选项进行检索
-
否
ETag
String
Object 生成时会创建相应的 ETag，ETag 用于标识一个 Object 的内容
count、distinct、group
是
FileModifiedTime
String
文件最近一次修改时间的时间戳，格式为 RFC3339Nano
count、distinct、group
是
Filename
String
文件路径
count、distinct、group
是
MediaType
String
文件媒体类型
枚举值：
image：图片
other：其他
document：文档
archive：压缩包
audio：音频
video：视频
count、distinct、group
是
ObjectACL
String
文件访问权限属性
count、distinct、group
是
ObjectId
String
对象唯一 ID
count、distinct、group
是
ServerSideEncryption
String
加密算法，需要设置 x-cos-server-side-encryption
count、distinct、group
是
Size
Int
文件大小，单位为字节
min、max、average、sum、count、distinct、group
是
UpdateTime
String
元数据修改时间的时间戳，格式为 RFC3339Nano
创建元数据后，如果未更新过元数据，则元数据修改时间的时间戳和元数据创建时间的时间戳相同
count、distinct、group
是
URI
String
资源标识字段，表示需要建立索引的文件地址
count、distinct、group
是



上一篇: 取消异步导出任务下一篇: 混合检索-图片检索

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈

搜索
    请输入关键词搜索文档