scylla-cqlsh 镜像文档

概述

scylla-cqlsh 是一个用于连接 ScyllaDB（或 Apache Cassandra）的命令行工具，它是 Apache Cassandra cqlsh 工具的分支版本。该工具提供便捷的数据库交互方式，支持执行 CQL 命令、交互式操作及通过云配置文件连接 Scylla Cloud。

核心功能与特性

• 多数据库兼容：支持连接 ScyllaDB 和 Apache Cassandra 数据库
• 交互式界面：提供交互式命令行环境，便于实时执行和调试 CQL 命令
• 云连接支持：通过云配置文件（connection bundle）连接 Scylla Cloud
• 命令行执行：支持直接运行单行 CQL 命令，无需进入交互式模式
• Docker 化部署：提供官方 Docker 镜像，简化环境配置与版本管理

使用场景与适用范围

• 数据库管理员通过命令行管理 ScyllaDB/Cassandra 集群
• 开发人员在开发测试中执行 CQL 命令进行数据操作
• 自动化脚本中集成 CQL 命令执行流程
• 通过 Scylla Cloud 管理远程数据库集群

使用方法与配置说明

Docker 镜像基本使用

交互式连接数据库

以交互式模式连接目标数据库主机：

docker run -it scylladb/scylla-cqlsh ${SCYLLA_HOST}

${SCYLLA_HOST} 需替换为实际数据库主机地址

执行单行 CQL 命令

直接执行指定 CQL 命令并退出：

docker run -it scylladb/scylla-cqlsh ${SCYLLA_HOST} -e 'SELECT * FROM system.local'

连接 Scylla Cloud

通过云配置文件连接 Scylla Cloud 集群：

# 需先将云配置文件挂载到容器内
docker run -it -v /本地路径/云配置文件:/cloudconf scylladb/scylla-cqlsh --cloudconf /cloudconf

非 Docker 环境补充说明

除 Docker 方式外，也可通过 pip 安装使用（非镜像相关，仅供参考）：

# 安装工具
pip install scylla-cqlsh

# 交互式连接
cqlsh ${SCYLLA_HOST}

# 通过云配置文件连接
cqlsh --cloudconf [云配置文件路径]