跳转到正文

每天都用 TablePro?购买许可证即可使用付费功能,并支持下个版本的开发。 购买许可证购买许可证,支持 TablePro

适用于 Mac 的 ClickHouse 客户端

通过 ClickHouse HTTP 接口运行分析 SQL,查看查询计划、pipeline 或行数估计,并在表的 Parts 标签页管理 MergeTree 数据部件和分区。长查询在运行时报告已读行数,Stop 会在服务器端终止。

适用于 MacMac 应用内置驱动

ClickHouse MergeTree 表的 Parts 标签页,列出分区、数据片及其行数。

概览

查询语言
SQL
驱动
随 Mac 应用内置
连接方式
主机和端口, SSH 隧道, SSL/TLS
默认端口
8123
iPhone 和 iPad
无法打开

连接

提供主机、HTTP 端口、用户,可选数据库。切换数据库原地完成,已打开标签页保持原数据库。View > Sidebar as Tree 将服务器数据库显示为可展开的树。

选择任意 SSL 模式切换为 HTTPS。443 或 ClickHouse Cloud 的 8443 端口会启用 Verify Identity,使用 CA 文件或系统信任库验证证书。Verify CA 需要 CA 文件,客户端证书和密钥可访问要求双向 TLS 的服务器。

未使用 TLS 时,请通过 SSH 隧道访问远程服务器,避免在网络上传输明文 HTTP。

查询和编辑

每个查询有独立 ID 并请求进度,长查询会持续报告读取行数。Stop 对该 ID 发送 KILL QUERY,连接的查询超时也传至服务器。

Explain 菜单提供 Plan、Pipeline、AST、Syntax、Estimate。缩进输出绘制为图或树,Estimate 显示查询预计读取的行、marks 和数据部件。

网格编辑先提供 Preview SQL,再发送 INSERT、ALTER TABLE … UPDATE、ALTER TABLE … DELETE。ClickHouse 以后台 mutation 执行更新删除,因此保存表示已接受而非已应用;system.mutations 显示进度。物化视图只读打开。

含 ClickHouse point 或 ring 元组的结果可在 地图视图打开。自带 FORMAT 子句的查询将服务器原始输出显示在单列中,要获得网格请省略该子句。

表、数据部件和分区

表提供 Structure、Indexes、DDL、Parts 标签页。Indexes 显示排序键和数据跳过索引,DDL 显示包含引擎和设置的完整 CREATE TABLE。

Parts 列出 system.parts 中每个数据部件及其分区、行数、磁盘大小、修改时间和 active 标志,可在此执行 Optimize、Drop Partition、Detach Partition。

Structure 标签页可添加、修改、删除列及删除数据跳过索引。排序键和主键在表创建时固定,新增数据跳过索引用 ALTER TABLE … ADD INDEX,其他修改需重建表。

监控

Server Dashboard 显示活动查询、合并、数据部件 mutation 和磁盘使用,列出其他会话并各提供 Terminate Session。慢查询从 system.query_log 读取最近完成且耗时超过一秒的查询。

移动数据

通过导入加载 CSV、TSV、JSON、JSONL、XLSX和SQL,表或查询结果导出为 CSV、JSON、SQL、XLSX、Markdown、HTML和XML。某列只要有一个非有效 UTF-8 值,就在网格中显示为十六进制;选择 toValidUTF8(column) 可按文本读取。

iPhone 和 iPad

iPhone 和 iPad 应用没有 ClickHouse 驱动。从 Mac 同步的 ClickHouse 连接会显示在列表中,但无法打开。

限制

  • 连接使用 ClickHouse 的 HTTP 接口,不使用原生 TCP 协议。
  • TLS 默认关闭。请在连接表单中选择 SSL 模式以使用 HTTPS。
  • 没有外键和事务。
  • SET 语句的设置不会延续至下一次查询。

关于 ClickHouse 的问题

如何仅为一个查询修改设置?

在查询自身加入 SETTINGS 子句,例如 SELECT … SETTINGS max_threads = 4。每条语句是无会话的独立 HTTP 请求,单独的 SET 不保留到下一条。

为什么端口 9000 无法连接?

9000 是 ClickHouse 原生 TCP 端口,TablePro 不使用它。请连接 HTTP 端口,ClickHouse Cloud 的 HTTPS 为 8443,并确认服务器 HTTP 接口已开启:该端口上的 /ping 请求应返回 Ok.。

获取 TablePro

Mac 应用可免费下载和使用。Starter 或 Team 方案添加可选功能。
下载 Mac 版

需要 macOS 13 Ventura 或更新版本