NixOS への ClickHouse のインストール

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

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

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

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

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

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

Nix を使うと、ClickHouse をシステムに恒久的に追加することなくインストールできます。

# 最新の安定版をインストール
nix shell nixpkgs#clickhouse

# または LTS バージョンをインストール
nix shell nixpkgs#clickhouse-lts

これにより、現在のシェルセッションで clickhouse バイナリを利用できるようになります。

• nixpkgs#clickhouse パッケージは最新の安定版を提供します。
• nixpkgs#clickhouse-lts パッケージは Long Term Support バージョンを提供します。
• どちらのパッケージも Linux と macOS で動作します。

ClickHouse をシステムに恒久的にインストールするには、次のようにします。

NixOS ユーザーの場合、configuration.nix に次を追加します。

environment.systemPackages = with pkgs; [
  clickhouse
];

次に、システムを再構築します。

sudo nixos-rebuild switch

NixOS 以外のユーザーの場合、Nix profile を使ってインストールします。

# 最新の安定版をインストール
nix profile install nixpkgs#clickhouse

# または LTS バージョンをインストール
nix profile install nixpkgs#clickhouse-lts

インストール後、ClickHouseサーバーを起動できます。

clickhouse-server

デフォルトでは、サーバーは基本設定で起動し、localhost:9000 で待ち受けます。

NixOS で本番用途に使用する場合は、ClickHouse をシステムサービスとして設定することをおすすめします。利用可能な設定オプションについては、NixOS manual を参照してください。

ClickHouseサーバーに接続するには、新しいターミナルを開いて次を実行します。

clickhouse-client