CQL map类型的大小限制：按行生效还是按表生效？

首先明确核心结论：Cassandra中map类型的64k条目限制是针对单一行数据的，而非整个表的全局限制。

为什么是行级限制？ #

Cassandra的map类型在底层存储时，会把每个键值对转换成当前行内的一个隐藏列。也就是说，这些map的键值对都是隶属于某一行的，不同行的map键值对是完全独立的存储单元，互相不会占用对方的配额。

结合你的场景分析 #

你的表设计中：

• 单条数据的dimensions条目很少，单个instanceId对应的facts集合最多250个dimensions，远低于64k的行级限制，完全没问题。
• 全局范围内不同instanceId使用不同的dimensions集合，这只会让不同行拥有不同的隐藏列，而Cassandra作为宽列数据库，天然支持行与行之间列结构的差异，不会触发所谓的“无限增长”导致的限制问题——只要每行自身的map条目数不超64k，就不会有架构隐患。

额外注意点 #

Cassandra单行的总列数（包括所有常规列和map展开的隐藏列）默认限制也是65535，不过你的场景下完全达不到这个阈值，无需担心。

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