帮你快速理解、总结文档立即下载

标量检索表达式语法

最近更新时间:2026-07-27 18:26:32
我的收藏

简介

通过本文您可以了解:
标量检索条件支持的字段(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
是