cqlsh

cqlsh 是一个基于Python的命令行客户端，用于在 cassandra 集群上运行 CQL 命令。

通常，它作为完整Apache Cassandra™安装的一部分进行打包。此存储库将其重新打包为独立的Python包，以便进行更轻量级的安装。

安装

使用pip进行安装和更新

$ pip install -U cqlsh

运行

$ cqlsh --help

文档

官方Apache Cassandra™文档中提供了文档。

贡献

由于这是从官方Cassandra存储库重新打包的cqlsh，因此**只有与PyPI打包相关的issue/PR应针对此存储库打开**。如果您想为cqlsh本身做出贡献，请在此处获取更多信息。

验证打包是否按预期工作的步骤

1. 在本地安装cqlsh（可能在virtualenv中）

$ pip install -e .  # run from within the cqlsh directory

2. 启动本地Cassandra副本

$ docker pull cassandra
$ docker run -it --rm -p 9042:9042 cassandra

3. 验证cqlsh成功连接到服务器

$ cqlsh

Connected to Test Cluster at 127.0.0.1:9042
[cqlsh 6.1.0 | Cassandra 4.1.0 | CQL spec 3.4.5 | Native protocol v5]
Use HELP for help.
cqlsh>

此PyPI包由Jeff Widman和Brad Schoening维护。前任维护者：Spiro和Andrew Mussey。

变更日志

不幸的是，Cassandra项目并不总是增加cqlsh版本号，因此对于每个发布版本，我们不仅需要记录cqlsh版本，还需要记录其中包含的cassandra版本。

6.2.0（2024年9月16日）

此包包含来自Cassandra 5.0.0的cqlsh 6.2.0

• 为CQLSH添加HISTORY命令（CASSANDRA-15046）
• 为CQLSH添加SHOW REPLICAS命令（CASSANDRA-17577）
• Cassandra 5.0已将所有cqlsh逻辑重构到cqlshlib中，新的cqlshmain.py取代了以前在bin/cqlsh.py中的行为
• 将'wcwidth.py'替换为pypi模块（CASSANDRA-17287）

6.1.3（2023年2月23日）

此包包含来自Cassandra 4.1.4的cqlsh 6.1.0

• CQLSH在服务器版本不匹配时发出警告（CASSANDRA-18745）
• 修复CQLSH在线帮助主题链接（CASSANDRA-17534）

6.1.2（由于版本问题而跳过）

此包包含来自Cassandra 4.1.1的cqlsh 6.1.0

• 现在支持Python 3.11。
• 尽管这是从Cassandra 4.x版本中提取的，但它与Cassandra 3.x集群兼容，除了需要4.x集群的DESCRIBE关键字外。

6.1.1（由于版本问题而跳过）

6.1.0（2023年1月4日）

此包包含来自Cassandra 4.1的cqlsh 6.1.0

• 需要Python 3.6+。
• 尽管这是从Cassandra 4.x版本中提取的，但它与Cassandra 3.x集群兼容，除了需要4.x集群的DESCRIBE关键字外。

6.0.1（2022年1月18日）

实际源代码与cqlsh 6.0.0发布完全相同，但现在它被打包为模块。这允许它不仅作为可执行脚本，还可以作为库使用。它还提供了更好的Windows支持。详细信息请参阅https://github.com/jeffwidman/cqlsh/pull/7中的@bschoening。

注意：此版本已从PyPI下架，因为它破坏了Python 2兼容性。

6.0.0（2021年8月3日）

此包包含来自Cassandra 4.0的cqlsh 6.0.0

• 需要Python 3.6+或2.7（尽管Python 2支持已弃用）。
• 尽管这是从Cassandra 4.x版本中提取的，但它通常可以针对Cassandra 3.x集群工作，而无需设置任何标志。

6.0.0b4（2021年3月9日）

此包包含来自Cassandra 4.0-beta4的cqlsh 5.0.1

• 现在支持Python 3。
• 尽管这是从Cassandra 4.x版本中提取的，但它通常可以针对Cassandra 3.x集群工作，而无需设置任何标志。

5.0.5（2021年3月9日）

此包包含来自Cassandra 3.11.10的cqlsh 5.0.1。

5.0.4 (2017年3月29日)

本包包含来自Cassandra 3.4.0的cqlsh 5.0.1。

5.0.3 (2016年3月21日)

本包包含来自Cassandra 2.2.0的cqlsh 5.0.1。

4.1.1 (2014年2月11日)

本包包含来自Cassandra 2.0.5的cqlsh 4.1.1。

4.1.0 (2013年12月2日)

本包包含来自Cassandra 2.0.3的cqlsh 4.1.0。

4.0.1 (2013年10月14日)

本包包含来自Cassandra 2.0.1的cqlsh 4.0.1。