Cassandra中CREATE COLUMNFAMILY报SyntaxException错误的排查与修正

错误原因 #

1. 语法结构不合法：CREATE COLUMNFAMILY（与CREATE TABLE功能等价）的语法规则要求，括号内必须先定义至少一个主键列，不能直接在括号内写WITH子句。你的语句跳过了列定义部分直接使用WITH，导致语法解析失败。
2. 版本兼容性限制：Docker运行的Cassandra应为3.x及以上版本，这类版本的CQL强制要求表定义必须指定主键——Cassandra依赖主键组织数据存储，旧版本中无列定义创建列族的方式已被废弃。
3. 参数格式过时：旧版CQL中用单引号包裹参数名的写法（如'key_validation_class'）在新版本中已不推荐，现在直接使用参数名即可。

修正方法 #

方法1：使用标准CREATE TABLE语法（推荐） #

新版本Cassandra官方推荐用CREATE TABLE替代CREATE COLUMNFAMILY，语法更清晰：

CREATE TABLE users (
    user_id text PRIMARY KEY
) WITH default_validation_class = text;

• user_id text PRIMARY KEY：定义主键列，类型为text（对应旧版UTF8Type），同时自动设置key_validation_class为text，无需单独指定。
• default_validation_class = text：设置默认列类型为text，匹配你原本的需求。

方法2：兼容旧版CREATE COLUMNFAMILY语法 #

若坚持使用CREATE COLUMNFAMILY，需补充主键列定义，并调整WITH子句位置：

CREATE COLUMNFAMILY users (
    user_id text PRIMARY KEY
) WITH key_validation_class = 'UTF8Type'
   AND comparator = 'UTF8Type'
   AND default_validation_class = 'UTF8Type';

注意：

• 若没有聚类列（复合主键的第二部分），comparator参数无实际作用，可省略。
• 新版本中UTF8Type已被text类型替代，推荐使用text以符合现代CQL规范。

关于“无列定义创建列族” #

Cassandra 3.x及以上版本不允许无列定义创建表/列族，必须至少定义一个主键列。这是因为Cassandra的存储模型依赖主键分区和组织数据，没有主键无法确定数据存储位置。

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