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

Install ClickHouse on Debian/Ubuntu

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

推奨事項を確認する​

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

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

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

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

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

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

Debian リポジトリをセットアップする​

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

# 必要なパッケージをインストール
sudo apt-get install -y apt-transport-https ca-certificates curl gnupg

# ClickHouse の GPG キーをダウンロードして keyring に保存
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 サーバー および client パッケージをインストール
sudo apt-get install -y clickhouse-server clickhouse-client

# ClickHouse サーバー サービスを起動
sudo service clickhouse-server start

# ClickHouse コマンドラインクライアントを起動
clickhouse-client # パスワードを設定した場合は "clickhouse-client --password" を使用します。

ClickHouse サーバー と client をインストールする​

sudo apt-get install -y clickhouse-server clickhouse-client

ClickHouse を起動する​

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

sudo service clickhouse-server start

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

clickhouse-client

サーバーにパスワードを設定した場合は、次を実行する必要があります:

clickhouse-client --password

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

ヒント

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

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

sudo apt-get install -y clickhouse-keeper

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

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

パッケージ​

利用可能な各種 deb パッケージの詳細は次のとおりです。

パッケージ名説明
clickhouse-common-staticClickHouse のコンパイル済みバイナリファイルをインストールします。
clickhouse-serverclickhouse-server のシンボリックリンクを作成し、デフォルトのサーバー設定ファイルをインストールします。
clickhouse-clientclickhouse-client およびその他のクライアント関連ツールのシンボリックリンクを作成し、クライアント設定ファイルをインストールします。
clickhouse-common-static-dbgデバッグ情報付きの ClickHouse のコンパイル済みバイナリファイルをインストールします。
clickhouse-keeper専用の ClickHouse Keeper ノードに ClickHouse Keeper をインストールするために使用します。ClickHouse server と同じサーバー上で 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