概览
- 查询语言
- SQL
- 驱动
- 随 Mac 应用提供
- 连接方式
- 主机和端口, SSH 隧道, SSL/TLS
- 默认端口
- 8123
- 最低版本
- 无要求


连接
输入主机、HTTP 端口、用户和可选数据库,无需重新连接即可切换数据库;已打开的标签页保留其最初的数据库。
选择任意 SSL 模式都会将连接切换为 HTTPS。端口为 443 或 ClickHouse Cloud 使用的 8443 时,会启用 Verify Identity,使用您的 CA 文件或系统信任库验证证书。Verify CA 需要 CA 文件,客户端证书和密钥可用于要求双向 TLS 的服务器。
未使用 TLS 时,请通过 SSH 隧道访问远程服务器,而不是在网络上传输明文 HTTP。
查询和编辑
Explain 菜单提供 Plan、Pipeline、AST、Syntax 和 Estimate。缩进输出会绘制为图表或树,Estimate 显示查询将读取的行、marks 和数据片段。运行中的查询会显示已读取的行数,Stop 发送 KILL QUERY,连接的查询超时也会传给服务器。
插入以及 UPDATE 和 DELETE mutation 可从网格运行。保存成功表示已接受,而非已应用:请在 system.mutations 中查看进度。物化视图只读。point 和 ring 元组可在 地图视图中打开;自带 FORMAT 子句的查询会将服务器原始输出显示在单列中,要获得网格请省略该子句。
表、数据片段和监控
表提供 Structure、Indexes、DDL 和 Parts 标签页。Indexes 显示排序键和数据跳过索引,DDL 显示包含引擎和设置的完整 CREATE TABLE,Parts 读取 system.parts,并提供 Optimize、Drop Partition 和 Detach Partition。Structure 标签页可更改列并删除数据跳过索引。排序键和主键在表创建时固定,因此请用 ALTER TABLE … ADD INDEX 添加数据跳过索引,其他更改需重建表。
Server Dashboard 显示活动查询、合并、数据片段 mutation 和磁盘使用,可结束其他会话,并从 system.query_log 列出耗时超过一秒的已完成查询。
本页介绍 ClickHouse 特有的内容。Safe Mode、AI 助手、MCP 服务器以及 TablePro 的其他功能请见功能页面。
其他
移动数据
导入 CSV、TSV、JSON、JSONL、XLSX 和 SQL 文件,并将表或结果导出为 CSV、JSON、SQL、XLSX、Markdown、HTML 和 XML。某列只要有一个值不是有效的 UTF-8,就会显示为十六进制;选择
toValidUTF8(column)即可按文本读取。限制
- 连接使用 ClickHouse 的 HTTP 接口,不使用原生 TCP 协议。
- TLS 默认关闭。请在连接表单中选择 SSL 模式以使用 HTTPS。
- 没有外键和事务。
- SET 语句的设置不会延续至下一次查询。
如何仅为一个查询修改设置?
在查询中加入
SETTINGS子句,例如SELECT … SETTINGS max_threads = 4。每条语句都是独立的 HTTP 请求,因此单独的SET到下一条语句时已失效。为什么端口 9000 无法连接?
9000 是 ClickHouse 的原生 TCP 端口,TablePro 不使用它。请连接 HTTP 端口,ClickHouse Cloud 上的 HTTPS 则使用 8443;HTTP 接口开启时,向该端口发送
/ping请求会返回Ok.。