全部产品
Search
文档中心

表格存储:多元索引使用限制

更新时间:Mar 10, 2025

通过本文您可以了解多元索引的使用限制。

索引限制

多元索引的行数、总大小、字段数量、读写速率、同步延迟、嵌套类型、表中字段的使用限制。具体说明请参见下表。

限制项

限制内容

说明

多元索引个数

无限制

推荐只创建一个包含所有需要检索字段的多元索引。

行数限制

1000亿

如果业务需求超过限制,请提交工单联系我们。

总大小限制

100 TB

如果业务需求超过限制,请提交工单联系我们。

多元索引字段个数

1000

无。

读写速率

5万行/s

  • 初始写入或瞬间写入时会有分钟级别负载均衡时间。

  • 文本类型的由于涉及分词会有较高CPU消耗,限制为1万行/s。

如果业务需求超过限制,请提交工单联系我们。

同步延迟

3秒

  • 99%情况下在3秒内。如果业务需求有更高要求,请提交工单联系我们。

  • 新建索引最多会有1分钟的初始化时间。

数组长度

256

数组中最多包含的元素个数。

Nested类型字段限制

多元索引内唯一

  • 嵌套类型字段最多支持5层Nested嵌套。

  • 嵌套类型字段中子行的最大数量为256。

  • 嵌套类型字段中子字段的最大数量为100。

向量类型字段限制

多元索引内唯一

  • 一个多元索引中最多包含1个向量类型字段。如果业务需求超过限制,请提交工单联系我们。

  • 向量类型字段支持的最大维度 (Dimension)为2048。

表主键列长度之和

1000字节

所有主键列的长度累加后不超过1000字节。

表主键列中String长度

1000字节

当为String类型的主键列建立索引时,列值长度不能超过1000字节。

表属性列中String长度(索引成Keyword)

4 KB

无。

表属性列中String长度(索引成Text)

2 MB

一般情况下,与数据表中属性列的长度限制相同。当对索引成Text类型的字段使用模糊分词方式进行模糊查询时,原文内容会限制最大1024字符或者汉字,超过后会截断,只保留前1024个字符或者汉字。

查询限制

Search接口

使用Search接口查询数据以及使用Search接口统计和分析数据时的使用限制。具体说明请参见下表。

分类

限制项

限制内容

说明

通用限制

offset+limit

100000

  • limit的默认值为10,最大值为100。如果业务需求超过限制,请提交工单联系我们。

    当使用Search接口查询指定列的数据时,如果多元索引中包含了查询列的数据,limit参数最大支持到1000,即一个请求最多返回1000条结果。

  • 如果业务需求超过限制,请使用next_token连续翻页。

timeout

10秒

无。

CU

无限制

无。

QPS

10万

针对于轻量的事务型查询(TP),QPS上限为10万。如果业务需求超过限制,请提交工单联系我们。

一次Search查询中Query个数

1024个

如果Search查询中的Query嵌套太复杂,则会影响查询效率,请注意精简Query。

多词精确查询

查询词个数

1024个

TermsQuery最多支持设置1024个查询词。

通配符查询

查询词长度

32字符

WildcardQuery的查询词长度不超过32字符。

前缀查询

查询词长度

1000字符

PrefixQuery的查询词长度不超过1000字符。

全文检索

高亮分片总个数

500个

所有inner_hits和highlight内最多支持请求返回的高亮分片总个数。

高亮字段数量

10个

最多支持为10个字段指定高亮参数。

向量检索

返回最相似的前TopK行数

1000

KnnVectorQuery最多返回前1000行。

统计聚合

同层Aggregation个数

5个

SubGroupBy中添加Aggregation重新从0计算。

同层GroupBy个数

5个

SubGroupBy中添加GroupBy重新从0计算。

GroupBy嵌套层数

3层

层数计算包含本身的GroupBy。

GroupByFilter中Filter个数

10个

无。

GroupByField返回的分组个数

2000个

无。

GroupByComposite内部sources个数

32个

多列字段分组支持的最大列数限制。

GroupByRange中Range个数

100个

无。

GroupByGeodistance中Range个数

10个

无。

ParallelScan接口

使用ParallelScan接口查询数据以及并发导出数据时的使用限制。具体说明请参见下表。

分类

限制项

限制内容

说明

通用限制

offset+limit

不支持

  • 无法指定offset+limit,只能从最开始往后面遍历。

  • limit的最大值为2000。

CU

无限制

无。

QPS

无限制

无。

并发导出数据

最大并发

等于MaxParallel值

ComputeSplits返回结果中的MaxParallel值。

任务有效时间(aliveTime)

10分钟

无。

同时存在的ParallelScan任务数限制

10个

同一个sessionId且ScanQuery相同的多个并发任务视为一个任务。更多信息,请参见并发导出数据