cqlsh

Cassandra CQL 命令行客户端

补充说明

cqlsh 是 Apache Cassandra 自带的交互式客户端，执行 CQL（Cassandra Query Language）。CQL 看起来像 SQL，但没有 JOIN、外键和跨分区事务，查询模式必须围绕分区键设计。

常用示例

cqlsh db.example.com 9042
cqlsh db.example.com 9042 -u app -p "$CASSANDRA_PASSWORD"
cqlsh db.example.com 9042 --ssl -u app -p "$CASSANDRA_PASSWORD"
cqlsh db.example.com -k app -e 'SELECT * FROM orders LIMIT 5;'
cqlsh db.example.com -f migration.cql

交互命令：

DESCRIBE KEYSPACES;
DESCRIBE TABLES;
DESCRIBE TABLE app.orders;
CONSISTENCY LOCAL_QUORUM;
TRACING ON;
SOURCE 'migration.cql';
COPY app.orders TO '/tmp/orders.csv' WITH HEADER = true;

易错点与排错

• CQL 不是 SQL：没有 JOIN、子查询和任意列过滤；WHERE 必须命中分区键/聚簇键。
• 未加引号的标识符会被转成小写；大小写敏感的名字要加双引号。
• 一致性级别影响延迟和正确性；跨机房读写先确认 CONSISTENCY 设置。
• ALLOW FILTERING 能跑但代价高；生产查询应通过数据模型解决。
• 大量 DELETE 会产生 tombstone，读放大严重；按 TTL 和 compaction 策略设计。
• 批量导入优先 COPY FROM 或 sstableloader，逐条 INSERT 很慢。
• TLS、认证和端口要匹配；9042 是原生协议，JMX 是另一个端口。
• 超时不一定是节点挂了；可能是 GC、热点分区或协调节点过载。

相关命令

• nodetool — 集群状态与运维
• cassandra — 服务端启动