跳转到正文

Cassandra 和 ScyllaDB 客户端

在 Cassandra、ScyllaDB 或 Amazon Keyspaces 上浏览键空间,运行 CQL,并按主键编辑行。

概览

查询语言
CQL
驱动
首次使用时下载与 ScyllaDB 共用
连接方式
主机和端口, SSH 隧道, SSL/TLS, AWS IAM
默认端口
9042
最低版本
3.0
Mac 上连接到 Cassandra 的 TablePro,显示一条 CQL 查询及其结果。

连接

输入联系节点、端口和所需凭据,然后选择键空间,或导入路径中包含键空间的 cassandra:// 或 cql:// URL;切换时,已打开的标签页保留其键空间。新连接默认关闭 TLS。由于驱动没有机会性 TLS,Preferred 和 Required 会加密但不验证证书;Verify CA 和 Verify Identity 需要 CA 证书文件,且绝不回退到系统根证书。如需双向 TLS,请添加客户端证书、其密钥和密钥密码。

Amazon Keyspaces 使用 SigV4 而非密码登录。将连接指向地域端点,例如 9142 端口上的 cassandra.us-east-1.amazonaws.com,选择 AWS IAM 模式 (英语),用户名和密码留空,并开启 TLS。

浏览和运行 CQL

网格显示集合、用户定义类型、时长、向量和 blob;编辑器结果只读,请在从侧边栏打开的表中编辑行。CQL 没有 OFFSET,因此从首行开始向前分页,跳到远处的页面需要读取此前的每一页。行按令牌顺序返回,点击列标题不会重新排序。精确计数 (Count Exactly) 运行 SELECT COUNT(*),会读取所有分区。

筛选会添加 ALLOW FILTERING,因此除非筛选固定了完整分区键,否则服务器会读取所有分区。包含、开头为和结尾为需要 SASI 或 SAI 索引,条件仅能以 AND 连接,因为 CQL 没有 OR。编辑会按 CQL 类型检查,并按完整主键写入;添加行 (Add Row) 使用 INSERT … IF NOT EXISTS,更改键需删除并重新插入该行。计数器列需要在编辑器中运行 UPDATE … SET c = c + 1。

键空间和表

Structure 标签页列出每列的 CQL 类型,将分区列和聚簇列标为主键,显示二级索引,并可添加和删除列;其他更改均需使用 CQL 语句。DDL 标签页根据列重建 CREATE TABLE,不含 compaction 和聚簇顺序,因此请在 cqlsh 中用 DESCRIBE TABLE 读取完整定义。

本页介绍 Cassandra 特有的内容。Safe Mode、AI 助手、MCP 服务器以及 TablePro 的其他功能请见功能页面。

ScyllaDB

ScyllaDB 有自己的连接类型,通过相同的 CQL 原生协议使用 Cassandra 驱动,因此上述连接、浏览、编辑和 Cassandra 的限制同样适用。scylladb:// 或 scylla:// URL 会创建 ScyllaDB 连接。

筛选栏有一个区别:ScyllaDB 在任何列上都接受包含、开头为和结尾为,而 Cassandra 需要 SASI 或 SAI 索引。请按 Cassandra 设置指南 (英语)进行配置。

默认端口
9042

其他

  • 移动数据

    将表或 CQL 结果导出为 CSV、JSON、SQL、XLSX、Markdown、HTML 和 XML。

  • 限制

    • 网格中仅可编辑标量列。集合、元组、用户定义类型和时长类型需在编辑器中使用 UPDATE。
    • 没有一致性级别设置。语句使用驱动默认值 LOCAL_ONE 运行。
    • 无法加载安全连接包,因此无法连接 DataStax Astra DB。
    • 侧边栏不列出物化视图和用户定义类型。
  • TablePro 会显示节点或环状态吗?

    不会。Cassandra 和 ScyllaDB 没有 Server Dashboard。请用 nodetool status 检查节点,用 TablePro 处理键空间、表和 CQL。

  • 如何查看物化视图和用户定义类型?

    在 CQL 编辑器中查询 system_schema 键空间,例如 SELECT * FROM system_schema.views 或 system_schema.types。

  • TablePro 能连接 Cassandra 2.x 吗?

    不能。驱动从 system_schema 读取结构,而 Cassandra 2.x 没有它,因此连接会失败。

获取 TablePro

本页功能全部免费。