多元索引使用限制 - Tablestore

本文介紹了建立多元索引時的Mapping限制，使用Search介面和ParallelScan介面查詢資料時的限制，多元索引速率、總大小、行數等限制以及多元索引的支援地區。

Mapping

建立多元索引時對欄位長度、欄位數量、欄位類型映射、巢狀型別、表中欄位等的使用限制。具體說明請參見下表。

名稱	最大值	說明
多元索引欄位數量	1000	可被索引的欄位數。
數組長度	256	數組中最多包含的元素個數。
Nested嵌套層數	5	最多支援5層Nested嵌套。
Nested欄位的子行數量	256	嵌套欄位的嵌套行最大數量，非子欄位數量。
Nested欄位數量	100	嵌套中子欄位的個數。
表主鍵列長度之和	1000位元組	所有主鍵列的長度累加後不超過1000位元組。
表主鍵列中String長度	1000位元組	當String類型的主鍵列要建立索引時，列值長度不能超過1000位元組。
表屬性列中String長度（索引成Keyword）	4 KB	無。
表屬性列中String長度（索引成Text）	2 MB	一般情況下，與資料表中屬性列的長度限制相同。當對索引成Text類型的欄位使用模糊分詞方式進行模糊查詢時，原文內容會限制最大1024字元或者漢字，超過後會截斷，只保留前1024個字元或者漢字。
萬用字元查詢的Query長度	32	不超過32字元。
首碼查詢的Query長度	1000位元組	不超過1000位元組。
向量欄位類型的個數	1	一個多元索引中最多建立1個向量欄位類型。如果業務需求超過限制，請提交工單聯絡我們。
向量欄位類型支援的最大維度（Dimension）	2048	向量維度最大值。
向量檢索KnnVectorQuery返回最相似的前TopK文檔數	1000	最多返回前1000文檔數。

Search

使用Search介面查詢資料以及使用Search介面統計和分析資料時的使用限制。具體說明請參見下表。

類別	名稱	最大值	說明
通用限制	offset+limit	50000	如果業務需求超過限制，請使用next_token。
	limit	100	預設值為10，最大值為100。當使用Search介面查詢指定列的資料時，如果多元索引中包含了查詢列的資料時，limit參數最大支援到1000，即一個請求最多返回1000條結果。如果業務需求超過限制，請提交工單聯絡我們。
	timeout	10s	無。
	CU	無限制	無。
	QPS	10萬	針對於輕量的事務型查詢（TP），QPS上限為10萬。如果業務需求超過限制，請提交工單聯絡我們。
	一次Search查詢中的Query個數	1024	如果Search查詢中的Query嵌套太複雜，則會影響查詢效率，請注意精簡Query。
	多詞精確查詢的查詢關鍵詞數量	1024	最多支援設定1024個查詢關鍵詞。
全文檢索索引	高亮分區總個數	500	所有inner_hits和highlight內最多支援要求返回的高亮分區總個數。
全文檢索索引	高亮欄位數量	10	資料查詢時，最多支援為10個欄位指定高亮參數。
統計彙總	同層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	無限制。
	最大並發	ComputeSplits的傳回值中的MaxParallel值。
	任務有效時間	任務有效時間（aliveTime）的最大值為10分鐘。
	任務數限制	同時存在的ParallelScan任務數不能超過10個。同一個sessionId且ScanQuery相同的多個並發任務視為一個任務。更多資訊，請參見並發匯出資料。

Index

多元索引的速率、同步延遲、行數和總大小的使用限制。具體說明請參見下表。

名稱	最大值	說明
速率	5萬行/s	初始寫入或瞬間寫入時會有分鐘層級負載平衡時間。文本類型的由於涉及分詞會有較高CPU消耗，限制為1萬行/s。如果業務需求超過限制，請提交工單聯絡我們。
同步延遲	3s	99%情況下在3秒內。建立索引最多會有1分鐘的初始化時間。
行數	1000億	如果業務需求超過限制，請提交工單聯絡我們。
總大小	100 TB	如果業務需求超過限制，請提交工單聯絡我們。

其他限制

目前多元索引功能開放的地區包括華東1（杭州）、華東2（上海）、華北1（青島）、華北2（北京）、華北3（張家口）、華北6（烏蘭察布）、華南1（深圳）、華南3（廣州）、西南1（成都）、中國香港、新加坡、馬來西亞（吉隆坡）、印尼（雅加達）、日本（東京）、德國（法蘭克福）、英國（倫敦）、美國（矽谷）、美國（維吉尼亞）、泰國（曼穀）、沙特（利雅得）和菲律賓（馬尼拉）。其中華北6（烏蘭察布）、泰國（曼穀）、美國（矽谷）和美國（維吉尼亞）地區暫不支援向量檢索功能。

說明

如果上述限制項不能滿足您的業務需求，請在阿里雲官網提交工單申請更高需求。在工單中請說明情境、限制項名稱、限制項的數量需求、申請需求的原因，在後續功能開發中會優先考慮您的需求。