Cassandra复合分区键仅指定首个键可查询，与文档要求不符的疑问

嘿，我来帮你解开这个Cassandra的小困惑！你遇到的情况其实是因为混淆了复合分区键和包含聚类键的复合主键这两个概念，我给你拆解清楚：

首先明确两个核心主键类型 #

1. 单一分区键 + 聚类键（最常见的复合主键） #

这种主键的定义没有双括号，格式如下：

CREATE TABLE killrvideo.videos5 (
    title text,
    added_year int,
    added_date timestamp,
    description text,
    video_id uuid,
    PRIMARY KEY (title, added_year, added_date) -- 无双括号
);

这里只有title是分区键，added_year和added_date属于聚类键（用来在分区内排序数据）。Cassandra的规则是：查询只要指定完整的分区键即可——这里分区键只有title一个，所以你只指定title的查询是完全合法的，不会报错，这就是你成功的原因。

2. 真正的复合分区键（多列共同组成分区键） #

这种情况需要用双括号把组成分区键的列括起来，格式如下：

CREATE TABLE killrvideo.videos5 (
    title text,
    added_year int,
    added_date timestamp,
    description text,
    video_id uuid,
    PRIMARY KEY ((title, added_year), added_date) -- 双括号包裹分区键列
);

这里title和added_year共同构成分区键，Cassandra要求查询必须指定所有分区键列，也就是必须同时写WHERE title = ? AND added_year = ?，只指定其中一个的话，默认会报错（除非你强制开启ALLOW FILTERING，但这会导致全表扫描，非常不推荐）。

你遇到的问题根源 #

你看的文档里提到的“复合分区键必须指定所有分区键”，指的是上面第二种带双括号的情况；但你自己创建的表应该是第一种情况——只有第一个列是单一分区键，后面的是聚类键，所以只指定第一个列的查询完全符合规则，自然能成功。

快速验证方法 #

你可以执行这条命令查看表的主键结构：

DESCRIBE TABLE killrvideo.videos5;

如果主键行显示的是PRIMARY KEY (title, added_year, added_date)，那就是单一分区键；如果是PRIMARY KEY ((title, added_year), added_date)，才是真正的复合分区键。

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