创建表时出现Mismatched unique constraint语法错误如何解决

报错原因 #

你当前使用的是Cassandra数据库，CQL语法本身不支持关系型数据库中常见的UNIQUE唯一约束定义。你在建表语句中追加的CONSTRAINT email_uq UNIQUE (email)不符合CQL语法规范，解析器执行语法校验时读到UNIQUE关键字无法匹配对应规则，因此抛出该语法错误。

解决方案 #

Cassandra中要实现字段唯一性校验，需要通过表结构设计配合业务逻辑实现，常用的两种方案如下：

• 新增独立的唯一索引表：专门新增一张以email作为主键的映射表，建表语句参考：

CREATE TABLE users_by_email (
    email text,
    user_id uuid,
    PRIMARY KEY (email)
);

写入用户数据时先操作这张映射表：如果写入时提示主键重复，说明email已被占用，终止写入流程；如果写入成功，再向原users_by_id表写入用户数据，两次写入可以通过Batch语句保证原子性。

• 调整原表主键结构：如果业务查询逻辑可以适配，直接把email字段加入原表的主键，利用Cassandra主键天然唯一的特性实现校验，不需要额外维护第二张表。

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