// HTTP 接口 · 分析

适用于 Mac、Windows 和 Linux 的 ClickHouse 客户端

一款真正理解 ClickHouse 的原生客户端,而不是假装它是事务型数据库:精确的宽整数、显示索引裁剪了哪些部分和粒度的计划、来自查询日志的洞察,以及在 ClickHouse 没有对应功能时的诚实拒绝。

连接方式
ClickHouse 的 HTTP 接口
默认端口
8123,或者使用 TLS 的 8443
登录
ClickHouse 用户名和密码
粘贴 URL
clickhouse://user:password@host:8123/database

SQLly 能为 ClickHouse 做什么

凡是 ClickHouse 有对应实现的 SQLly 工具,都直接作用于 ClickHouse 的系统表。没有对应实现的——因为 ClickHouse 没有事务、没有行级更新、也没有索引使用计数器——会直接说明,而不是中途失败。

保留每一位数字的结果

结果会在 ClickHouse 发送时流入网格。大整数和小数保留精确位数,数组、元组和映射显示为 JSON 文本,多语句脚本会报告每个结果集或写入的行数。

流式结果 →

显示索引修剪的执行计划

估计计划来自 ClickHouse 的 JSON EXPLAIN 并显示每个索引跳过了多少个数据部分和粒度——这个数字能告诉你主键和跳数索引是否真正物有所值。

查询计划 →

实时查询,支持 Kill

活动监视器列出正在运行的内容并可将其终止,查询标签页中的取消按钮会在服务器上停止查询,查询洞察则读取查询日志,给出热门查询和最近的失败。

活动监视器 →

遵循 MergeTree 的结构编辑

表结构编辑器处理 ADD, DROP, RENAME 和 MODIFY COLUMN 以及跳数索引,并把对键的更改标出来交由人工审核。数据传输到 ClickHouse 会创建 MergeTree 表。

数据传输 →

备份、恢复和优化

备份 / 恢复驱动器 BACKUP 和 RESTORE DATABASE 到单位上,或使用 OPTIMIZE TABLE … FINAL 合并一张表的各个部分。

备份 / 恢复 →

用户与授权,脚本化

只读的安全视图会显示 ClickHouse 用户、角色和授权,并生成 CREATE USER 和 GRANT 语句供你检查和运行 - ClickHouse 的访问控制留在 SQL 里,这本就是它该在的地方。

安全性 →

连接到 ClickHouse

  1. 下载 SQLly 适用于 macOS、Windows 或 Linux,从 下载页面 并打开它。
  2. 创建连接并选择 ClickHouse。 SQLly 使用 ClickHouse 的 HTTP 接口,因此端口默认为 8123(使用 TLS 时请用 8443)。
  3. 输入主机、用户和密码,数据库可选,或者粘贴一个 clickhouse://user:password@host:8123/database URL。密码会保存到你的操作系统钥匙串中。
  4. 选择 TLS 模式 至于私有服务器,还有 SSH 隧道、代理或 Kubernetes 端口转发——它们的工作方式与 PostgreSQL 和 MySQL 完全一样。
  5. 测试、保存并连接,然后在树中浏览数据库,从资源管理器的“工具”子菜单或命令面板使用这些工具。

ClickHouse 上的每个 SQLly 工具

应用用来启用或禁用菜单的正是这份引擎矩阵,所以你在这里看到什么,应用里就是什么样。当某个工具不适用于 ClickHouse 时,应用会说明原因——我们也会。

SQLly 工具及其在 ClickHouse 上的可用性
工具 ClickHouse
资源管理器、IntelliSense 和悬停卡片 是
估计的执行计划 是 EXPLAIN json = 1, indexes = 1:显示每个索引分别裁剪掉了哪些 part 和 granule。
活动监视器 是 运行查询,支持终止(Kill)。
查询洞察 是 查询日志:热门查询和最近失败。
服务器仪表板 是
磁盘使用和对象浏览器 是
维护菜单 是 OPTIMIZE TABLE … FINAL.
模式比较与模式历史 是
数据比较 是
数据传输 是 表会以 MergeTree 引擎创建。
测试数据生成器 是
表结构编辑器 是 列和跳数索引;键的变更会标记出来,需人工审核。
安全编辑器(用户、角色、授权) 部分 只读视图,可生成 CREATE USER 和 GRANT 语句脚本。
备份 / 恢复 是 对服务器的备份磁盘执行 BACKUP / RESTORE DATABASE。
SSH 隧道、代理和 Kubernetes 端口转发 是
只读连接 是
在结果网格中编辑行 否 ClickHouse 没有行级的 UPDATE 或 DELETE;在查询选项卡中使用 ALTER TABLE … UPDATE / DELETE。
实际(已执行)计划 否 ClickHouse 没有 EXPLAIN ANALYZE;可以在查询洞察(Query Insights)中查看运行时的行数、字节数和内存。
索引分析器 否 没有索引使用计数器;索引剪枝情况可在估算计划中查看。
创建和删除数据库对话框 否 在查询标签页中运行 CREATE DATABASE / DROP DATABASE。
过程模式 否 仅支持 SQL Server 和 PostgreSQL。
SQL 代理、扩展事件和引导式设计器 否 仅适用于 SQL Server 和 Azure SQL。
自动回滚安全防护 否 ClickHouse 没有事务,因此 SQLly 会拒绝在回滚包裹下运行。

关于 SQLly 中 ClickHouse 的问题

SQLly 连接的是 ClickHouse 的哪个端口?

SQLly 与 ClickHouse 的 HTTP 接口通信:默认端口为 8123,使用 TLS 时为 8443。SSH 隧道、SOCKS 和 HTTP 代理、Kubernetes 端口转发以及四种 TLS 模式的工作方式与 PostgreSQL 和 MySQL 相同。

我可以在结果网格中编辑 ClickHouse 的行吗?

不。ClickHouse 没有行级的 UPDATE 或 DELETE,因此不提供网格内的行编辑;可以在查询标签页里用 ALTER TABLE … UPDATE 或 DELETE 来改行。表结构编辑器支持 ADD、DROP、RENAME、MODIFY COLUMN 以及数据跳过索引。

我可以查看并停止正在运行的 ClickHouse 查询吗?

是的。活动监视器会列出正在运行的查询并可以终止它们;查询标签页里的“取消”会在服务器端停止该查询;查询洞察则读取查询日志,展示 Top 查询和最近的失败。

为什么自动回滚设置在 ClickHouse 上不起作用?

ClickHouse 没有事务,回滚包裹无法撤销任何更改,每个改动都会生效。开启该设置后,SQLly 会拒绝在 ClickHouse 连接上运行语句并说明原因,而不是给你一种虚假的安全感。

// 在你自己的 ClickHouse 上尝试

把你的 ClickHouse 带回家给小猪

SQLly 在 macOS、Windows 和 Linux 上免费即可上手,无需账户。