适用于 Mac 的 Cassandra、ScyllaDB 客户端
浏览键空间和表,在编辑器运行 CQL,编辑按完整主键写回的行。同一驱动也连接 ScyllaDB 和 Amazon Keyspaces。
适用于 Mac首次选择 Cassandra 时下载驱动


概览
- 查询语言
- CQL
- 驱动
- 首次使用时下载与 ScyllaDB 共用
- 连接方式
- 主机和端口, SSH 隧道, SSL/TLS, AWS IAM
- 默认端口
- 9042
- 最低版本
- 3.0,文档所述
- iPhone 和 iPad
- 无法打开
连接
提供联系点和端口,集群配置认证器时再填用户名和密码。无键空间字段:连接后在侧栏选择,或放入 cassandra://、cql:// URL 路径再导入。键空间原地切换,列表排除系统键空间,已打开标签页仍留在各自键空间。
新连接关闭 TLS。驱动没有机会性 TLS,因此 Preferred、Required 均加密但不验证证书。Verify CA、Verify Identity 必须有 CA 证书文件,绝不回退系统根证书。双向 TLS 添加客户端证书、密钥和密钥密码。私网集群通过 SSH 隧道访问。
Amazon Keyspaces 用 SigV4 而非密码登录。连接地域端点,例如 9142 端口的 cassandra.us-east-1.amazonaws.com,Authentication 设置为 AWS IAM 模式 (英语)(访问密钥、配置或 AWS IAM Identity Center),留空用户名密码并开启 TLS,因为 Keyspaces 拒绝明文。
浏览和运行 CQL
从侧栏打开表读取数据网格。列表、集合、映射和元组显示为集合,用户定义类型显示字段,duration 为 1d2h30m,向量为数字列表,blob 为十六进制。CQL 编辑器结果只读,请从侧栏打开的表修改行。
CQL 无 OFFSET,因此从首行向前分页:已显示页的 Next、Previous 各读一次,跳到远处需读取此前每页。行按令牌顺序返回,列头不重新排序,因为 CQL 仅能按单分区内聚簇列排序。打开表不计数;Count Exactly 运行 SELECT COUNT(*) 读取所有分区。
筛选添加 ALLOW FILTERING,除非固定完整分区键,否则服务器读所有分区。包含、开头为、结尾为发送 LIKE,Cassandra 仅在有 SASI 或 SAI 索引的列接受。CQL 无法表达的不等于、is NULL 等运算符按名称拒绝;CQL 无 OR,条件仅以 AND 连接。
编辑值按列的 CQL 类型发送,无法解析的值停止整个保存。各行以完整主键用独立语句写入。Add Row 写 INSERT … IF NOT EXISTS,新行绝不覆盖已有相同键的行。键列不可原地修改,需删除再添加行。
计数器列需在 CQL 编辑器运行 UPDATE … SET c = c + 1,服务器拒绝网格编辑的普通 UPDATE。连接超时取自 Options;CQL 请求保持驱动自身固定超时,应用查询超时不改变它。
键空间和表
Structure 标签页列出各列 CQL 类型,将分区键和聚簇列均标为主键,并显示二级索引。可添加删除列;其他修改包括索引均在编辑器用 CQL 语句执行。
DDL 标签页从列列表重建 CREATE TABLE,省略 compaction 等表选项、聚簇顺序及分区键和聚簇键的区分。请在 cqlsh 用 DESCRIBE TABLE 读取完整定义。用户定义函数和聚合列在 Functions 下。
移动数据
TablePro 不提供 Cassandra 或 ScyllaDB 导入。将表或 CQL 结果导出为 CSV、JSON、SQL、XLSX、Markdown、HTML和XML。
iPhone 和 iPad
iPhone 和 iPad 应用没有 Cassandra 驱动。从 Mac 同步的 Cassandra 连接会显示在列表中,但无法打开。
限制
- 网格中仅可编辑标量列。集合、元组、用户定义类型和时长类型需在编辑器中使用 UPDATE。
- 没有一致性级别设置。语句使用驱动默认值 LOCAL_ONE 运行。
- 无法加载安全连接包,因此无法连接 DataStax Astra DB。
- 侧边栏不列出物化视图和用户定义类型。
ScyllaDB
默认端口 9042首次使用时下载iPhone 和 iPad: 无法打开
ScyllaDB 在连接类型列表有独立条目,通过相同 CQL 原生协议使用 Cassandra 驱动,因此上述连接、浏览、编辑及限制完全适用。scylladb:// 或 scylla:// URL 创建 ScyllaDB 连接。
筛选栏有一个区别:ScyllaDB 在任何列接受包含、开头为、结尾为发送的 LIKE,Cassandra 则需 SASI 或 SAI 索引。ScyllaDB 按 Cassandra 设置指南 (英语)配置。
关于 Cassandra 的问题
显示节点或环状态吗?
不显示。Cassandra、ScyllaDB 无 Server Dashboard。用 nodetool status 检查节点,用 TablePro 操作键空间、表和 CQL。
如何查看物化视图和用户定义类型?
侧栏不显示,请在 CQL 编辑器查询 system_schema 键空间,例如 SELECT * FROM system_schema.views 或 system_schema.types。
能连接 Cassandra 2.x 吗?
不能。驱动从 Cassandra 2.x 没有的 system_schema 读取结构,因此连接失败。
获取 TablePro
需要 macOS 13 Ventura 或更新版本