Cassandra报错system_schema不存在的原因及解决方法

报错原因 #

• Cassandra版本不匹配：system_schema是Cassandra 3.0及以上版本才引入的系统键空间，若安装的是2.x及更早版本，该键空间不存在，旧版本对应的系统键空间为system。
• 安装初始化失败：Cassandra启动时未成功创建系统键空间，可能是安装过程中权限不足、配置文件路径错误、启动端口冲突等导致初始化流程中断。
• 节点运行异常：连接的Cassandra节点未正常启动，或处于故障状态，无法访问系统键空间。

解决办法 #

• 确认版本并调整查询语句
  1. 在cqlsh中执行兼容查询：SELECT release_version FROM system.local;，查看当前Cassandra版本。
  2. 若为2.x版本，将原查询替换为：SELECT * FROM system.schema_keyspaces;；若为3.x及以上版本，继续排查其他问题。
• 检查节点运行状态
  1. 执行命令：nodetool status，确认节点状态是否为UN（正常运行状态）。
  2. 若节点未启动，查看Cassandra日志文件（默认路径为/var/log/cassandra/或安装目录下的logs文件夹），定位失败原因：
     • 权限问题：确保Cassandra运行用户对数据目录、日志目录拥有读写权限。
     • 端口冲突：检查cassandra.yaml中配置的7000、9042等端口是否被其他程序占用。
  3. 修复问题后，重启Cassandra服务。
• 重新初始化系统键空间（仅适用于新安装实例）
  1. 停止Cassandra服务：sudo service cassandra stop（不同系统命令可能为systemctl stop cassandra）。
  2. 删除数据目录：sudo rm -rf /var/lib/cassandra/data/（路径以实际配置为准）。
  3. 重新启动Cassandra服务，系统会自动重建系统键空间。

注意：重新初始化会清空所有数据，仅在新安装且无重要数据的场景下使用。

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