简介
通过本文您可以了解简单查询条件支持的字段(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 | 是 |