字段和操作符的支持列表

最近更新时间:2025-11-04 17:15:02

我的收藏

简介

通过本文您可以了解简单查询条件支持的字段(Field)和操作符(Operation),以及字段对应操作符的支持情况。
简单查询条件中支持使用的操作符包括 eq(等于)、gt(大于)、gte(大于等于)、lt(小于)、lte(小于等于)、nested(嵌套查询)、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