メインコンテンツへスキップ

tgz アーカイブを使用して ClickHouse をインストールする

deb または rpm パッケージをインストールできない Linux ディストリビューションでは、公式の事前コンパイル済み tgz アーカイブを使用することを推奨します。
1

推奨事項を確認する

ClickHouse をインストールする前に、次の推奨事項を確認してください。
  • スワップ: 本番環境では、オペレーティングシステムのスワップファイルを無効にしてください。
  • ディスク容量: ClickHouse バイナリのインストールには、少なくとも 2.5 GB のディスク容量が必要です。
  • ネットワーク: 分散デプロイメント (クラスター構成) では、少なくとも 10 Gbit のネットワーク接続を使用してください。大量の中間データを伴う分散クエリの処理やレプリケーションでは、ネットワーク帯域幅が重要です。
ストレージ要件の見積もりデータに必要なディスク容量を見積もるには:
  1. データ量を見積もる: データのサンプルを取得して平均的な行サイズを計算し、それに保存予定の行数を掛けます。
  2. 圧縮係数を適用する: サンプルを ClickHouse にロードし、元のデータサイズと保存後のテーブルサイズを比較します。たとえば、クリックストリームデータは通常 6~10 倍に圧縮されます。
  3. レプリカを考慮する: 複数のレプリカにデータを保存する予定がある場合は、見積もり容量にレプリカ数を掛けます。
より詳細なハードウェア要件については、“サイジングとハードウェアの推奨事項” を参照してください。
2

最新の stable バージョンをダウンロードしてインストールする

必要なバージョンは、リポジトリ https://packages.clickhouse.com/tgz/ から curl または wget を使ってダウンロードできます。 その後、ダウンロードしたアーカイブを展開し、インストールスクリプトを使ってインストールします。以下は、最新の stable バージョンをインストールする例です。
本番環境では、最新の stable バージョンを使用することを推奨します。 リリース番号は、この GitHub page で、接尾辞 -stable が付いたものとして確認できます。
3

最新の ClickHouse バージョンを取得する

GitHub から最新の ClickHouse バージョンを取得し、LATEST_VERSION 変数に保存します。
4

システムアーキテクチャを検出する

システムアーキテクチャを検出し、それに応じて ARCH 変数を設定します。
5

各 ClickHouse コンポーネントの tarball をダウンロードする

各 ClickHouse コンポーネントの tarball をダウンロードします。このループでは、まずアーキテクチャ固有の パッケージを試し、利用できない場合は汎用パッケージにフォールバックします。
6

パッケージを展開してインストールする

以下のパッケージを展開してインストールするには、次のコマンドを実行します。
  • clickhouse-common-static
  • clickhouse-common-static-dbg
  • clickhouse-server
  • clickhouse-client
最終更新日 2026年6月19日