clickhouse-sql-parser for Mac 版
用纯 Go 编写 ClickHouse SQL 解析器
clickhouse-sql-parser 是什么
clickhouse-sql-parser 是一个用 Go 编写的 ClickHouse SQL 解析器,目标是把 ClickHouse SQL 解析成 AST,并对 SQL 格式进行美化。项目受 Spanner 的 Go SQL 解析器 memefish 启发,既可以作为 Go 库使用,也能作为 CLI 工具调用。
核心能力包括:将 ClickHouse SQL 解析为 AST,再把 AST 还原成 SQL 语句;通过 -beautify 参数为复杂查询添加合适的缩进和换行,提升可读性。AST 遍历推荐使用 Walk 模式,提供 Walk、WalkWithBreak、Find、FindAll、Transform 等函数,支持深度优先遍历、提前终止、按条件查找节点以及节点变换。针对行策略,CREATE、ALTER、DROP [ROW] POLICY 都有专门的 AST 节点,并支持 SHOW CREATE [ROW] POLICY 和 SHOW [ROW] POLICIES 检查。
它适合需要在 Go 项目中处理 ClickHouse SQL 的开发者,比如做 SQL 分析、查询改写、策略检查或格式化工具的人。SigNoz、Unkey、Akvorado、Trickster、Measure 等项目已经在使用它。
核心能力包括:将 ClickHouse SQL 解析为 AST,再把 AST 还原成 SQL 语句;通过 -beautify 参数为复杂查询添加合适的缩进和换行,提升可读性。AST 遍历推荐使用 Walk 模式,提供 Walk、WalkWithBreak、Find、FindAll、Transform 等函数,支持深度优先遍历、提前终止、按条件查找节点以及节点变换。针对行策略,CREATE、ALTER、DROP [ROW] POLICY 都有专门的 AST 节点,并支持 SHOW CREATE [ROW] POLICY 和 SHOW [ROW] POLICIES 检查。
它适合需要在 Go 项目中处理 ClickHouse SQL 的开发者,比如做 SQL 分析、查询改写、策略检查或格式化工具的人。SigNoz、Unkey、Akvorado、Trickster、Measure 等项目已经在使用它。
如何安装 clickhouse-sql-parser
- 打开 终端(按 ⌘ + 空格,输入“终端”)。
- 如果还没安装 Homebrew,先运行下面这条安装命令。
- 运行下面这条命令:
最近 10 个版本记录
最近一次更新为 2026-11-12,当前版本 v0.5.7,共记录最近 10 个版本。
| 版本 | 发布日期 | 类型 | 大小 | macOS | Windows | Linux |
|---|---|---|---|---|---|---|
| v0.5.7 | 2026-11-12 | 稳定版 | — | — | — | — |
| v0.5.6 | 2026-08-12 | 稳定版 | — | — | — | — |
| v0.5.5 | 2026-08-06 | 稳定版 | — | — | — | — |
| v0.5.4 | 2026-08-02 | 稳定版 | — | — | — | — |
| v0.5.3 | 2026-07-29 | 稳定版 | — | — | — | — |
| v0.5.2 | 2026-07-11 | 稳定版 | — | — | — | — |
| v0.5.1 | 2026-04-21 | 稳定版 | — | — | — | — |
| v0.5.0 | 2026-03-18 | 稳定版 | — | — | — | — |
| v0.4.19 | 2026-01-26 | 稳定版 | — | — | — | — |
| v0.4.18 | 2025-12-25 | 稳定版 | — | — | — | — |
数据来自 GitHub Releases,稳定版优先,同类按发布时间排序。
二进制包支持平台
Homebrew 官方提供的预编译包(bottle)覆盖:
- Apple 芯片 · 最新 macOS
- Apple 芯片 · macOS 26 Tahoe
- Apple 芯片 · macOS 15 Sequoia
- Linux · ARM64
- Linux · x86_64
⚠️ 未提供 Intel Mac 的预编译包,Intel 机型需要通过 brew install --build-from-source 从源码编译。
与同类应用对比
只对比公开元数据,不做主观推荐;需要逐项对比时见对比页。
| 应用 | 版本 | 许可证 | 架构 | 近 30 天安装 |
|---|---|---|---|---|
| clickhouse-sql-parser | v0.5.7 | MIT | 命令行 | 4 |
| zfind | v0.4.7 | MIT | 命令行 | 2 |
| fsql | v0.5.2 | MIT | 命令行 | 3 |
| RazorSQL | 11.0.3 | — | 通用二进制 | 3 |