字段和操作符的支持列表

通过本文您可以了解简单查询条件、聚合操作和地理位置查询中支持的字段(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(分组计数,当分组较大时可能会存在误差)。

  • 目前支持地理位置查询的字段为LatLong,相应的操作符有如下三种:

    • geo-distance:以中心点按半径搜索,格式为"纬度,经度;距离米"。例如"33,119;1000"表示以"33,119"为中心,1000米为半径搜索。

    • geo-bounding-box:按矩形搜索,按左上、右下的顺序传入经纬度坐标,格式为"纬度,经度;纬度,经度"。例如"35,118.5;33.5,120"表示以左上坐标为"35,118.5",右下坐标为"33.5,120"的矩形搜索。

    • geo-polygon:按多边形搜索,传入依次连接起来构成多边形的多个经纬度坐标(至少三个坐标点才能构成多边形),格式为"纬度,经度;纬度,经度;纬度,经度;..."。例如"33,118;33,120;35,120;35,118"表示以"33,118”、“33,120”、“35,120”、“35,118"四个经纬度顺序连接起来组成的多边形搜索。

  • 使用Customlabels字段搜索文件时,系统会按照对象标签的Key-Value来搜索文件。对象标签的Key和Value均不区分大小写。

    例如要搜索包含Bucket=examplebucket标签的文件,您需要设置查询条件为{"Bucket": "examplebucket"}

  • 使用OSSTagging.*字段搜索文件时,请替换星号(*)为对象标签的Key,系统会按照对象标签的Key-Value来搜索文件。对象标签的Key和Value均区分大小写。

    例如要搜索包含owner=John标签的文件,您需要设置查询条件为{"Field": "OSSTagging.owner", "Value": "John", "Operation": "eq"}

  • 使用OSSUserMeta.*字段搜索文件时,请替换星号(*)为用户自定义元数据的Key,系统会按照用户自定义元数据的Key-Value来搜索文件。用户自定义元数据的Key不区分大小写,Value区分大小写。

    例如要搜索包含x-oss-meta-location=hangzhou用户自定义元数据的文件,您需要设置查询条件为{"Field": "OSSUserMeta.x-oss-meta-location", "Value": "hangzhou", "Operation": "eq"}

字段和操作符的支持列表

下表列出了简单查询条件和聚合操作中支持的字段,以及字段对相应操作符的支持情况。

说明

表格中“#”标注的字段为预留字段,目前暂不可用。

简单查询条件

Field(字段)

操作符

是否支持排序

eq、gt、gte、lt、lte

match-phrase

prefix

nested

exist

AccessControlAllowOrigin

支持

不支持

支持

不支持

不支持

支持

AccessControlRequestMethod

支持

不支持

支持

不支持

不支持

支持

Addresses.AddressLine

不支持

支持

不支持

支持

支持

不支持

Addresses.City

支持

不支持

支持

支持

支持

不支持

Addresses.Country

支持

不支持

支持

支持

支持

不支持

Addresses.District

支持

不支持

支持

支持

支持

不支持

Addresses.Language

支持

不支持

支持

支持

支持

不支持

Addresses.Province

支持

不支持

支持

支持

支持

不支持

Addresses.Township

支持

不支持

支持

支持

支持

不支持

Album

支持

不支持

支持

不支持

不支持

支持

AlbumArtist

支持

不支持

支持

不支持

不支持

支持

Artist#

支持

不支持

支持

不支持

不支持

支持

AudioStreams.CodecName

支持

不支持

支持

支持

支持

不支持

AudioStreams.Language

支持

不支持

支持

支持

支持

不支持

AudioStreams.Lyric

不支持

支持

不支持

支持

支持

不支持

Bitrate

支持

不支持

不支持

不支持

不支持

支持

Bodies.Confidence

支持

不支持

不支持

支持

支持

不支持

CacheControl

支持

不支持

支持

不支持

不支持

支持

Composer#

支持

不支持

支持

不支持

不支持

支持

ContentDisposition

支持

不支持

支持

不支持

不支持

支持

ContentEncoding

支持

不支持

支持

不支持

不支持

支持

ContentLanguage

支持

不支持

支持

不支持

不支持

支持

ContentType

支持

不支持

支持

不支持

不支持

支持

CreateTime

支持

不支持

不支持

不支持

不支持

支持

CroppingSuggestions.AspectRatio

支持

不支持

支持

支持

支持

不支持

CroppingSuggestions.Confidence

支持

不支持

不支持

支持

支持

不支持

CustomId

支持

不支持

支持

不支持

不支持

支持

CustomLabels.*

支持

不支持

支持

不支持

支持

不支持

DocumentContent

不支持

支持

不支持

不支持

不支持

不支持

DocumentText

支持

支持

不支持

不支持

支持

支持

Duration

支持

不支持

不支持

不支持

不支持

支持

ETag

支持

不支持

支持

不支持

不支持

支持

Figures.Age

支持

不支持

不支持

支持

支持

不支持

Figures.AgeSD

支持

不支持

不支持

支持

支持

不支持

Figures.Emotion

支持

不支持

支持

支持

支持

不支持

Figures.EmotionConfidence

支持

不支持

不支持

支持

支持

不支持

Figures.FaceQuality

支持

不支持

不支持

支持

支持

不支持

Figures.FigureClusterId

支持

不支持

支持

支持

支持

不支持

Figures.FigureConfidence

支持

不支持

不支持

支持

支持

不支持

Figures.FigureId

支持

不支持

支持

支持

支持

不支持

Figures.FigureType

支持

不支持

支持

支持

支持

不支持

Figures.Gender

支持

不支持

支持

支持

支持

不支持

Figures.GenderConfidence

支持

不支持

不支持

支持

支持

不支持

FileAccessTime

支持

不支持

不支持

不支持

不支持

支持

FileHash

支持

不支持

支持

不支持

不支持

支持

FileModifiedTime

支持

不支持

不支持

不支持

不支持

支持

Filename

支持

支持

支持

不支持

不支持

支持

ImageHeight

支持

不支持

不支持

不支持

不支持

支持

ImageWidth

支持

不支持

不支持

不支持

不支持

支持

Labels.CentricScore

支持

不支持

不支持

支持

支持

不支持

Labels.LabelConfidence

支持

不支持

不支持

支持

支持

不支持

Labels.LabelLevel

支持

不支持

不支持

支持

支持

不支持

Labels.LabelName

支持

不支持

支持

支持

支持

不支持

Labels.Language

支持

不支持

支持

支持

支持

不支持

Labels.ParentLabelName

支持

不支持

支持

支持

支持

不支持

LatLong

支持

不支持

不支持

不支持

不支持

不支持

MediaType

支持

不支持

支持

不支持

不支持

支持

ObjectACL

支持

不支持

支持

不支持

不支持

支持

ObjectId

支持

不支持

支持

不支持

不支持

支持

OCRContents.Contents

不支持

支持

不支持

支持

支持

不支持

OCRContents.Language

支持

不支持

支持

支持

支持

不支持

OSSCRC64

支持

不支持

支持

不支持

不支持

支持

OSSDeleteMarker

支持

不支持

支持

不支持

不支持

支持

OSSExpiration

支持

不支持

不支持

不支持

不支持

支持

OSSObjectType

支持

不支持

支持

不支持

不支持

支持

OSSStorageClass

支持

不支持

支持

不支持

不支持

支持

OSSTagging.*

支持

不支持

支持

不支持

支持

不支持

OSSTaggingCount

支持

不支持

不支持

不支持

不支持

支持

OSSURI

支持

不支持

支持

不支持

不支持

支持

OSSUserMeta.*

支持

不支持

支持

不支持

支持

不支持

OSSVersionId

支持

不支持

支持

不支持

不支持

支持

PageCount

支持

不支持

不支持

不支持

不支持

支持

Performer

支持

不支持

支持

不支持

不支持

支持

ProduceTime

支持

不支持

不支持

不支持

不支持

支持

ServerSideDataEncryption

支持

不支持

支持

不支持

不支持

支持

ServerSideEncryption

支持

不支持

支持

不支持

不支持

支持

ServerSideEncryptionCustomerAlgorithm

支持

不支持

支持

不支持

不支持

支持

ServerSideEncryptionKeyId

支持

不支持

支持

不支持

不支持

支持

Size

支持

不支持

不支持

不支持

不支持

支持

Subtitles.CodecName

支持

不支持

支持

支持

支持

不支持

Subtitles.Content

不支持

支持

不支持

支持

支持

不支持

Subtitles.Language

支持

不支持

支持

支持

支持

不支持

Title

支持

支持

支持

不支持

不支持

支持

UpdateTime

支持

不支持

不支持

不支持

不支持

支持

URI

支持

不支持

支持

不支持

不支持

支持

VideoHeight

支持

不支持

不支持

不支持

不支持

支持

VideoScore

支持

不支持

不支持

不支持

不支持

支持

VideoStreams.CodecName

支持

不支持

支持

支持

支持

不支持

VideoStreams.Language

支持

不支持

支持

支持

支持

不支持

VideoWidth

支持

不支持

不支持

不支持

不支持

支持

聚合操作

Field(字段)

操作符

是否支持排序

min、max、average、sum

count、distinct、group

AccessControlAllowOrigin

不支持

支持

支持

AccessControlRequestMethod

不支持

支持

支持

Addresses.AddressLine

不支持

不支持

不支持

Addresses.City

不支持

不支持

不支持

Addresses.Country

不支持

不支持

不支持

Addresses.District

不支持

不支持

不支持

Addresses.Language

不支持

不支持

不支持

Addresses.Province

不支持

不支持

不支持

Addresses.Township

不支持

不支持

不支持

Album

不支持

支持

支持

AlbumArtist

不支持

支持

支持

Artist#

不支持

支持

支持

AudioStreams.CodecName

不支持

不支持

不支持

AudioStreams.Language

不支持

不支持

不支持

AudioStreams.Lyric

不支持

不支持

不支持

Bitrate

支持

支持

支持

Bodies.Confidence

不支持

不支持

不支持

CacheControl

不支持

支持

支持

Composer#

不支持

支持

支持

ContentDisposition

不支持

支持

支持

ContentEncoding

不支持

支持

支持

ContentLanguage

不支持

支持

支持

ContentType

不支持

支持

支持

CreateTime

不支持

支持

支持

CroppingSuggestions.AspectRatio

不支持

不支持

不支持

CroppingSuggestions.Confidence

不支持

不支持

不支持

CustomId

不支持

支持

支持

CustomLabels.*

不支持

不支持

不支持

DocumentContent

不支持

支持

不支持

Duration

支持

支持

支持

ETag

不支持

支持

支持

Figures.Age

不支持

不支持

不支持

Figures.AgeSD

不支持

不支持

不支持

Figures.Emotion

不支持

不支持

不支持

Figures.EmotionConfidence

不支持

不支持

不支持

Figures.FaceQuality

不支持

不支持

不支持

Figures.FigureClusterId

不支持

不支持

不支持

Figures.FigureConfidence

不支持

不支持

不支持

Figures.FigureId

不支持

不支持

不支持

Figures.FigureType

不支持

不支持

不支持

Figures.Gender

不支持

不支持

不支持

Figures.GenderConfidence

不支持

不支持

不支持

FileAccessTime

不支持

支持

支持

FileHash

不支持

支持

支持

FileModifiedTime

不支持

支持

支持

Filename

不支持

支持

支持

ImageHeight

支持

支持

支持

ImageWidth

支持

支持

支持

Labels.CentricScore

不支持

不支持

不支持

Labels.LabelConfidence

不支持

不支持

不支持

Labels.LabelLevel

不支持

不支持

不支持

Labels.LabelName

不支持

不支持

不支持

Labels.Language

不支持

不支持

不支持

Labels.ParentLabelName

不支持

不支持

不支持

Language

不支持

支持

支持

LatLong

不支持

支持(支持count、distinct)

不支持

MediaType

不支持

支持

支持

ObjectACL

不支持

支持

支持

ObjectId

不支持

支持

支持

OCRContents.Contents

不支持

不支持

不支持

OCRContents.Language

不支持

不支持

不支持

OSSCRC64

不支持

支持

支持

OSSDeleteMarker

不支持

支持

支持

OSSExpiration

不支持

支持

支持

OSSObjectType

不支持

支持

支持

OSSStorageClass

不支持

支持

支持

OSSTagging.*

不支持

不支持

不支持

OSSTaggingCount

支持

支持

支持

OSSURI

不支持

支持

支持

OSSUserMeta.*

不支持

不支持

不支持

OSSVersionId

不支持

支持

支持

PageCount

支持

支持

支持

Performer

不支持

支持

支持

ProduceTime

不支持

支持

支持

ServerSideDataEncryption

不支持

支持

支持

ServerSideEncryption

不支持

支持

支持

ServerSideEncryptionCustomerAlgorithm

不支持

支持

支持

ServerSideEncryptionKeyId

不支持

支持

支持

Size

支持

支持

支持

Subtitles.CodecName

不支持

不支持

不支持

Subtitles.Content

不支持

不支持

不支持

Subtitles.Language

不支持

不支持

不支持

Title

不支持

支持

支持

UpdateTime

不支持

支持

支持

URI

不支持

支持

支持

VideoHeight

支持

支持

支持

VideoScore

支持

支持

支持

VideoStreams.CodecName

不支持

不支持

不支持

VideoStreams.Language

不支持

不支持

不支持

VideoWidth

支持

支持

支持