NixOS への ClickHouse のインストール

NixOS および Nix を使用した ClickHouse のインストール

​

NixOS に ClickHouse をインストールする

ClickHouse は Nixpkgs リポジトリで提供されており、Linux と macOS では Nix を使ってインストールできます。

1. ​

   推奨事項を確認する

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

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

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

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

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

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

2. ​

   Nix を使って ClickHouse をインストールする

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

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

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

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

   恒久的なインストール

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

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

   environment.systemPackages = with pkgs; [
     clickhouse
   ];
   

   次に、システムを再ビルドします。

   sudo nixos-rebuild switch
   

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

   # 最新の stable バージョンをインストール
   nix profile install nixpkgs#clickhouse
   
   # または LTS バージョンをインストール
   nix profile install nixpkgs#clickhouse-lts
   
4. ​

   ClickHouse server を起動する

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

   clickhouse-server
   

   デフォルトでは、server は基本的な構成で起動し、localhost:9000 で待ち受けます。

   NixOS で本番利用する場合は、ClickHouse を system service として構成することをおすすめします。利用可能な構成オプションについては、NixOS マニュアル を参照してください。

5. ​

   ClickHouse client を起動する

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

   clickhouse-client
   

​

Nix パッケージについて

Nixpkgs の ClickHouse パッケージには、以下が含まれます。

• clickhouse-server - ClickHouse データベースサーバー
• clickhouse-client - ClickHouse に接続するためのコマンドラインクライアント
• clickhouse-local - ローカルファイルに対して SQL クエリを実行するツール
• その他の ClickHouse ユーティリティ

Nixpkgs の ClickHouse パッケージの詳細については、以下を参照してください。

• Nixpkgs ClickHouse package
• NixOS ClickHouse service options