Homebrew を使用して ClickHouse をインストールする

注意

Homebrew の Formulae を使用したインストールは非推奨となり、2026-09-01 に無効化される予定です。代わりに、任意のプラットフォームで動作するクイックインストール方法の使用を推奨します。

推奨事項を確認する

ClickHouse をインストールする前に、次の推奨事項を確認してください。

スワップ: プロダクション環境では、オペレーティングシステムのスワップファイルを無効にします。
ディスク容量: ClickHouse バイナリのインストールには、少なくとも 2.5 GB のディスク容量が必要です。
ネットワーク: 分散デプロイメント (クラスタリング) では、少なくとも 10 Gbit のネットワーク接続を使用します。大量の中間データを伴う分散クエリの処理やレプリケーションでは、ネットワーク帯域幅が重要です。

ストレージ要件の見積もり

データに必要なディスク容量を見積もるには、次の手順に従います。

データ量を見積もる: データのサンプルを取り、1 行あたりの平均サイズを計算して、保存予定の行数を掛けます。
圧縮率を適用する: サンプルデータを ClickHouse にロードし、元のデータサイズと格納後のテーブルサイズを比較します。たとえば、クリックストリームデータは通常 6～10 倍に圧縮されます。
レプリカを考慮する: 複数のレプリカにデータを保存する予定がある場合は、見積もり容量にレプリカ数を掛けます。

より詳細なハードウェア要件については、「サイジングとハードウェアの推奨事項」を参照してください。

macOS 上で Homebrew を使用して ClickHouse をインストールするには、 ClickHouse コミュニティ提供の homebrew formula を使用できます。

brew install --cask clickhouse

brew を使用して ClickHouse をインストールした場合、macOS からエラーが表示されることがあります。デフォルトでは、macOS は確認できない開発元によって作成されたアプリケーションやツールを実行しません。

clickhouse コマンドを実行しようとすると、次のようなエラーが表示されることがあります。

この検証エラーを回避するには、システム設定ウィンドウで該当する設定を変更するか、ターミナルを使用するか、または ClickHouse を再インストールするなどして、いずれかの方法で macOS の隔離領域からアプリを削除する必要があります。

clickhouse 実行ファイルを隔離領域から削除する最も簡単な方法は次のとおりです。

システム設定 を開きます。
プライバシーとセキュリティ に移動します。
ウィンドウの一番下までスクロールし、「_"clickhouse-macos-aarch64" は、認証済みの開発元によるものではないため、使用がブロックされました。」というメッセージを探します。
それでも開く をクリックします。
macOS のユーザーアカウントのパスワードを入力します。

これでターミナルで clickhouse コマンドを実行できるようになるはずです。

それでも開く ボタンを押してもこの問題が解消しない場合は、コマンドラインを使って同じ処理を行うことができます。あるいは、単にコマンドラインを使う方が好みの場合もあるでしょう。

まず、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]

Brew には、インストールされたバイナリを最初から隔離しないためのコマンドラインオプションがあります。

まず、ClickHouse をアンインストールします。

brew uninstall clickhouse

次に、--no-quarantine を付けて ClickHouse を再インストールします。

brew install --no-quarantine clickhouse