如何调优QuestDB的Symbol列与索引容量以保障最优性能？

Symbol列容量设置 #

Symbol的CAPACITY参数是预分配的哈希表大小，用于存储唯一值与内部编码的映射关系。由于你已有1M个唯一值，且每日新增数据可能带来新的唯一值，必须将容量设为大于当前唯一值数量，并预留足够增长空间：

• 建议设置为1500000（1.5M），比现有唯一值多50%余量，避免后续因新唯一值触发自动扩容（扩容会重建哈希表，临时阻塞写入并消耗系统资源）。
• 若能预估未来半年到1年的唯一值增长上限，直接设为该上限值效果最佳。

索引容量设置 #

Symbol索引的INDEX CAPACITY需要与Symbol列的容量匹配，因为索引是基于Symbol的内部编码值构建的：

• 索引容量至少要等于Symbol列的容量，否则会出现索引空间不足问题，同样触发扩容开销。
• 建议直接设为与Symbol列相同的1500000，确保索引与Symbol映射表完全匹配，避免不必要的内存分配。

调整后的SQL示例 #

CREATE TABLE my_table (symb SYMBOL CAPACITY 1500000 INDEX CAPACITY 1500000);

额外性能优化提示 #

• 若每日新增的10M行中，新唯一值占比极低（比如不足0.1%），可启用Symbol的CACHE参数（SYMBOL CAPACITY 1500000 CACHE），将高频访问的Symbol编码值缓存到内存，进一步提升查询性能。
• 针对大流量写入，建议按时间戳排序后批量写入（QuestDB对时序数据的有序写入优化更充分），同时避免在写入过程中频繁执行高开销查询。

内容的提问来源于stack exchange，提问作者Andrei Pechkurov