Debian/UbuntuにClickHouseをインストールする

Debian/Ubuntu LinuxにClickHouseをインストールする

Debian または Ubuntu では、公式の事前コンパイル済み deb パッケージを使用することを推奨します。

1. ​

   推奨事項を確認する

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

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

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

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

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

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

2. ​

   Debian リポジトリを設定する

   ClickHouse をインストールするには、次のコマンドを実行します。

   # 前提パッケージをインストール
   sudo apt-get install -y apt-transport-https ca-certificates curl gnupg
   
   # ClickHouse の GPG キーをダウンロードしてキーリングに保存
   curl -fsSL 'https://packages.clickhouse.com/rpm/lts/repodata/repomd.xml.key' | sudo gpg --dearmor -o /usr/share/keyrings/clickhouse-keyring.gpg
   
   # システムアーキテクチャを取得
   ARCH=$(dpkg --print-architecture)
   
   # ClickHouse リポジトリを apt ソースに追加
   echo "deb [signed-by=/usr/share/keyrings/clickhouse-keyring.gpg arch=${ARCH}] https://packages.clickhouse.com/deb stable main" | sudo tee /etc/apt/sources.list.d/clickhouse.list
   
   # apt パッケージリストを更新
   sudo apt-get update
   

   • 必要に応じて stable を lts に置き換えることで、異なるリリース種別を利用できます。
   • packages.clickhouse.com からパッケージを手動でダウンロードしてインストールすることもできます。

   
   

   古いディストリビューションで deb パッケージをインストールする方法

   # 前提パッケージをインストール
   sudo apt-get install apt-transport-https ca-certificates dirmngr
   
   # パッケージ認証用に ClickHouse の GPG キーを追加
   sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754
   
   # ClickHouse リポジトリを apt ソースに追加
   echo "deb https://packages.clickhouse.com/deb stable main" | sudo tee \
       /etc/apt/sources.list.d/clickhouse.list
       
   # apt パッケージリストを更新
   sudo apt-get update
   
   # ClickHouse サーバー と ClickHouse クライアント パッケージをインストール
   sudo apt-get install -y clickhouse-server clickhouse-client
   
   # ClickHouse サーバー サービスを起動
   sudo service clickhouse-server start
   
   # ClickHouse コマンドライン client を起動
   clickhouse-client # password を設定している場合は "clickhouse-client --password"
   
3. ​

   ClickHouse サーバー と ClickHouse クライアント をインストールする

   sudo apt-get install -y clickhouse-server clickhouse-client
   
4. ​

   ClickHouse を起動する

   ClickHouse サーバー を起動するには、次を実行します。

   sudo service clickhouse-server start
   

   ClickHouse クライアント を起動するには、次を実行します。

   clickhouse-client
   

   server に password を設定している場合は、次を実行する必要があります。

   clickhouse-client --password
   
5. ​

   スタンドアロンの ClickHouse Keeper をインストールする

   production 環境では、ClickHouse Keeper は専用ノードで実行することを強く推奨します。 テスト環境で ClickHouse Server と ClickHouse Keeper を同じ server 上で実行する場合は、 ClickHouse サーバー に ClickHouse Keeper が含まれているため、ClickHouse Keeper をインストールする必要はありません。

   スタンドアロンの ClickHouse Keeper サーバーに clickhouse-keeper をインストールするには、次を実行します。

   sudo apt-get install -y clickhouse-keeper
   
6. ​

   ClickHouse Keeper を有効化して起動する

   sudo systemctl enable clickhouse-keeper
   sudo systemctl start clickhouse-keeper
   sudo systemctl status clickhouse-keeper
   

​

パッケージ

利用可能な各種 deb パッケージについて、以下に詳しく説明します。

Package	Description
clickhouse-common-static	ClickHouse のコンパイル済みバイナリファイルをインストールします。
clickhouse-server	clickhouse-server のシンボリックリンクを作成し、デフォルトのサーバー設定をインストールします。
clickhouse-client	clickhouse-client およびその他のクライアント関連ツールのシンボリックリンクを作成し、クライアント設定ファイルをインストールします。
clickhouse-common-static-dbg	デバッグ情報付きの ClickHouse コンパイル済みバイナリファイルをインストールします。
clickhouse-keeper	専用の ClickHouse Keeper ノードに ClickHouse Keeper をインストールする際に使用します。ClickHouse サーバー と同じサーバーで ClickHouse Keeper を実行している場合、このパッケージをインストールする必要はありません。ClickHouse Keeper と、デフォルトの ClickHouse Keeper 設定ファイルをインストールします。

特定のバージョンの ClickHouse をインストールする必要がある場合は、すべてのパッケージを同じバージョンでインストールする必要があります。 sudo apt-get install clickhouse-server=21.8.5.7 clickhouse-client=21.8.5.7 clickhouse-common-static=21.8.5.7