Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

tgz アーカイブを使用した ClickHouse のインストール

View as MarkdownEdit this pageReport an issueSet up docs MCP

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

推奨事項を確認する

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

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

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

データに必要なディスク容量を見積もるには:

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

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

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

必要なバージョンは、リポジトリ https://packages.clickhouse.com/tgz/ から curl または wget を使用してダウンロードできます。 その後、ダウンロードしたアーカイブを展開し、インストールスクリプトを使ってインストールします。

以下は、最新の stable バージョンをインストールする例です。

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

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

LATEST_VERSION=$(curl -s https://raw.githubusercontent.com/ClickHouse/ClickHouse/master/utils/list-versions/version_date.tsv | \
    grep -Eo '[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+' | sort -V -r | head -n 1)
export LATEST_VERSION

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

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

case $(uname -m) in
  x86_64) ARCH=amd64 ;;         # Intel/AMD 64ビットプロセッサの場合
  aarch64) ARCH=arm64 ;;        # ARM 64ビットプロセッサの場合
  *) echo "Unknown architecture $(uname -m)"; exit 1 ;; # サポート対象外のアーキテクチャの場合は終了
esac

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

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

for PKG in clickhouse-common-static clickhouse-common-static-dbg clickhouse-server clickhouse-client clickhouse-keeper
do
  curl -fO "https://packages.clickhouse.com/tgz/stable/$PKG-$LATEST_VERSION-${ARCH}.tgz" \
    || curl -fO "https://packages.clickhouse.com/tgz/stable/$PKG-$LATEST_VERSION.tgz"
done

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

以下のコマンドを実行して、次のパッケージを展開し、インストールします。

  • clickhouse-common-static
# clickhouse-common-static パッケージを展開してインストール
tar -xzvf "clickhouse-common-static-$LATEST_VERSION-${ARCH}.tgz" \
  || tar -xzvf "clickhouse-common-static-$LATEST_VERSION.tgz"
sudo "clickhouse-common-static-$LATEST_VERSION/install/doinst.sh"
  • clickhouse-common-static-dbg
# デバッグシンボルパッケージを展開してインストール
tar -xzvf "clickhouse-common-static-dbg-$LATEST_VERSION-${ARCH}.tgz" \
  || tar -xzvf "clickhouse-common-static-dbg-$LATEST_VERSION.tgz"
sudo "clickhouse-common-static-dbg-$LATEST_VERSION/install/doinst.sh"
  • clickhouse-server
# 設定を含めて server パッケージを展開してインストール
tar -xzvf "clickhouse-server-$LATEST_VERSION-${ARCH}.tgz" \
  || tar -xzvf "clickhouse-server-$LATEST_VERSION.tgz"
sudo "clickhouse-server-$LATEST_VERSION/install/doinst.sh" configure
sudo /etc/init.d/clickhouse-server start  # server を起動
  • clickhouse-client
# client パッケージを展開してインストール
tar -xzvf "clickhouse-client-$LATEST_VERSION-${ARCH}.tgz" \
  || tar -xzvf "clickhouse-client-$LATEST_VERSION.tgz"
sudo "clickhouse-client-$LATEST_VERSION/install/doinst.sh"
Navigation