跳转到主内容
跳转到主内容

使用 Homebrew 安装 ClickHouse

注意

通过 Homebrew Formulae 安装的方式现已被弃用，并将于 2026-09-01 起停用。 我们推荐使用适用于任何平台的快速安装方式。

查看建议​

在安装 ClickHouse 之前，请先查看以下建议：

  • 交换空间： 在生产环境中禁用操作系统的交换文件。
  • 磁盘空间： 安装 ClickHouse 二进制文件至少需要 2.5 GB 的磁盘空间。
  • 网络： 对于分布式部署 (集群) ，请使用至少 10 Gbit 的网络连接。对于处理包含大量中间数据的分布式查询以及进行数据复制，网络带宽至关重要。

估算存储需求

要估算数据所需的磁盘空间，请执行以下操作：

  1. 估算数据量： 取一份数据样本，计算平均每行大小，再乘以计划存储的行数。
  2. 应用压缩系数： 将一份样本加载到 ClickHouse 中，比较原始数据大小与表的存储大小。例如，Clickstream 数据通常可压缩 6-10 倍。
  3. 将副本计算在内： 如果计划将数据存储在多个副本中，请将估算出的数据量乘以副本数量。

有关更详细的硬件要求，请参阅"容量规划与硬件建议"

使用社区 Homebrew formula 安装​

要在 macOS 上使用 Homebrew 安装 ClickHouse，可以使用 ClickHouse 社区提供的 homebrew formula。

brew install --cask clickhouse

在 macOS 中修复开发者验证错误​

如果你使用 brew 安装 ClickHouse，可能会遇到来自 macOS 的错误提示。 默认情况下，macOS 不会运行由无法验证身份的开发者创建的应用程序或工具。

当尝试运行任意 clickhouse 命令时，你可能会看到如下错误：

MacOS 开发者验证错误对话框

要绕过此验证错误，你需要将该应用从 macOS 的隔离区中移除，可以通过以下任一方式完成：在系统设置窗口中找到相应设置、使用终端，或者重新安装 ClickHouse。

系统设置流程​

将 clickhouse 可执行文件从隔离区移除的最简单方式是：

  1. 打开 系统设置 (系统设置) 。

  2. 进入 隐私与安全 (隐私与安全) ：

    MacOS 隐私与安全设置的默认视图

  3. 滚动到窗口底部，找到一条消息，内容为 "clickhouse-macos-aarch64" was blocked from use because it is not from an identified developer" (由于“clickhouse-macos-aarch64”不是来自已识别的开发者，因此被阻止使用) 。

  4. 点击 仍要允许 (仍要允许) 。

    MacOS 隐私与安全设置中显示 Allow Anyway 按钮

  5. 输入你的 macOS 用户密码。

现在你应该可以在终端中运行 clickhouse 命令了。

终端流程​

有时点击 Allow Anyway 按钮并不能解决该问题，在这种情况下，你也可以通过命令行来完成这一流程。 或者你可能只是更喜欢使用命令行！

首先确定 Homebrew 安装 clickhouse 可执行文件的位置：

which clickhouse

应输出类似以下内容：

/opt/homebrew/bin/clickhouse

通过运行 xattr -d com.apple.quarantine 命令，并在其后加上上一条命令输出的路径，将 clickhouse 从隔离区中移除：

xattr -d com.apple.quarantine /opt/homebrew/bin/clickhouse

现在应该已经可以运行 clickhouse 可执行文件：

clickhouse

应该输出类似下面的内容：

Use one of the following commands:
clickhouse local [args]
clickhouse client [args]
clickhouse benchmark [args]

通过重新安装 ClickHouse 来修复问题​

Homebrew 提供了一个命令行选项，可以从一开始就避免对已安装的二进制文件进行隔离。

首先卸载 ClickHouse：

brew uninstall clickhouse

现在使用 --no-quarantine 选项重新安装 ClickHouse：

brew install --no-quarantine clickhouse