如何在Cassandra表中实现非主键字段的唯一性约束？

Cassandra原生确实不支持非主键字段的唯一性强制约束，也没法直接对非主键用DISTINCT做唯一性校验。要实现手机号、邮箱的全局唯一，得靠**额外的校验表+轻量事务（LWT）**来实现，下面是具体的设计思路和操作流程：

1. 表结构设计 #

主用户表（存储完整信息） #

因为你要求username作为聚类键，需要搭配一个分区键来分散数据（避免单分区过大），这里可以用username的前缀哈希或者固定标识（用户量不大时适用）：

CREATE TABLE user_profiles (
    partition_key TEXT,  -- 比如用substr(username, 0, 2)做前缀分区，或固定值如'user'
    username TEXT,
    full_name TEXT,
    phone TEXT,
    email TEXT,
    PRIMARY KEY (partition_key, username)
);

唯一性校验表（分别管控手机号和邮箱） #

创建两张单主键表，把需要唯一的字段作为主键，存储对应的username：

-- 手机号唯一映射表
CREATE TABLE unique_phone (
    phone TEXT PRIMARY KEY,
    username TEXT
);

-- 邮箱唯一映射表
CREATE TABLE unique_email (
    email TEXT PRIMARY KEY,
    username TEXT
);

2. 插入用户的流程 #

必须先校验唯一性，再插入主表，用Cassandra的IF NOT EXISTS轻量事务保证原子性，结合批量操作确保所有表的操作一致：

BEGIN BATCH
    -- 先校验手机号是否已存在，不存在才插入
    INSERT INTO unique_phone (phone, username) VALUES ('138xxxxxx', 'zhangsan') IF NOT EXISTS;
    -- 再校验邮箱是否已存在，不存在才插入
    INSERT INTO unique_email (email, username) VALUES ('zhangsan@example.com', 'zhangsan') IF NOT EXISTS;
    -- 最后插入主用户表
    INSERT INTO user_profiles (partition_key, username, full_name, phone, email) 
    VALUES ('zh', 'zhangsan', '张三', '138xxxxxx', 'zhangsan@example.com');
APPLY BATCH;

如果手机号或邮箱已经被占用，整个批量操作会失败，应用层可以捕获这个错误并提示用户。

3. 更新手机号/邮箱的流程 #

如果用户需要修改手机号或邮箱，得先删除旧的唯一映射，再插入新的映射（同样用LWT校验）：

BEGIN BATCH
    -- 删除旧手机号的映射
    DELETE FROM unique_phone WHERE phone = '旧手机号';
    -- 插入新手机号，校验唯一性
    INSERT INTO unique_phone (phone, username) VALUES ('新手机号', 'zhangsan') IF NOT EXISTS;
    -- 更新主表的手机号
    UPDATE user_profiles SET phone = '新手机号' WHERE partition_key = 'zh' AND username = 'zhangsan';
APPLY BATCH;

4. 注意事项 #

• 所有涉及手机号、邮箱的操作必须走校验表，不能直接修改主表，否则会破坏唯一性约束；
• 分区键的选择要根据用户量调整：用户量小时用固定值即可，用户量大时建议用哈希前缀分散分区，避免单分区数据过多影响性能；
• 跨分区的批量操作依赖Cassandra的最终一致性，但LWT的IF NOT EXISTS会保证单条记录的原子性，只要应用层严格遵循流程，就能保证唯一性。

内容的提问来源于stack exchange，提问作者Norbu M Ashraf