如何设置默认CQL版本？解决cqlsh连接版本不兼容问题

咱们一个个来解决你的问题：

首先得明确：CQL版本和Cassandra的原生协议版本是绑定的，不同Cassandra版本对应不同的CQL版本范围。比如你遇到的3.4.4是Cassandra 3.x系列支持的CQL版本，对应的原生协议是v4。

更改CQL版本主要有两种场景：

• 临时切换：就是你已经在用的方式，启动cqlsh时显式指定版本：cqlsh --cqlversion=3.4.4
• 永久设置默认值：这就是你第二个问题要解决的，下面详细说明。

有几种简单的方法可以实现，不用每次手动加参数：

方法1：修改cqlsh配置文件（推荐） #

cqlsh会读取用户主目录下的.cqlshrc配置文件（如果存在的话）。如果没有这个文件，直接新建一个即可：

1. 打开终端，编辑（或创建）~/.cqlshrc文件：

   nano ~/.cqlshrc
   

2. 在文件中添加以下内容：

   [connection]
   cqlversion = 3.4.4
   

3. 保存退出后，下次直接运行cqlsh就会自动使用3.4.4版本连接了。

方法2：设置环境变量 #

如果你不想修改配置文件，可以通过环境变量临时或永久设置：

• 临时生效（仅当前终端会话）：

  export CQLSH_CQLVERSION=3.4.4
  

• 永久生效（每次登录终端都自动设置）：
  把上面的命令添加到你的shell配置文件里，比如：
  • 用bash的话，编辑~/.bashrc
  • 用zsh的话，编辑~/.zshrc
    添加后执行source ~/.bashrc（或对应文件）让配置立即生效。

额外注意点 #

• 确保你的cqlsh版本支持3.4.4这个CQL版本——既然你已经能通过--cqlversion参数成功连接，说明你的cqlsh是兼容的，不用额外担心。
• 如果是你自己管理Cassandra集群，也可以检查节点的cassandra.yaml配置里的native_transport_protocol_version，确保节点端的协议版本和你用的CQL版本匹配，但这一步不是必须的，客户端指定版本即可正常连接。

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