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

注記

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

コミュニティ版 Homebrew formula を使用してインストールする

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

brew install --cask clickhouse

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

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

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

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

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

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

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

brew uninstall clickhouse

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

brew install --no-quarantine clickhouse