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

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

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

推奨事項を確認する​

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

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

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

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

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

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

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

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

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

注記

本番環境では、最新の stable バージョンを使用することを推奨します。 リリース番号は、この GitHub ページ で -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  # サーバーを起動
  • 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"