メインコンテンツへスキップ
このセクションのデプロイ例は、ClickHouse Support and Services 組織が ClickHouse ユーザー向けに提供しているアドバイスに基づいています。いずれも実際に動作する例ですので、まず試したうえで、要件に合わせて調整することをお勧めします。ここに掲載されている例の中に、要件にぴったり合うものが見つかるかもしれません。 example repo では、さまざまなトポロジーに対応した複数の「レシピ」を提供しています。このセクションの例が要件に完全には合わない場合は、そちらも確認することをお勧めします。

用語

レプリカ

データのコピーです。ClickHouse には常に少なくとも 1 つのデータコピーが存在するため、レプリカ の最小数は 1 です。これは重要な点です。元のデータコピーをレプリカとして数えることに慣れていないかもしれませんが、ClickHouse のコードやドキュメントではこの用語が使われています。データに 2 つ目のレプリカを追加すると、耐障害性が得られます。

分片

データの一部分です。ClickHouse では、データには常に少なくとも 1 つの分片があります。そのため、データを複数のサーバーに分割しない場合、データは 1 つの分片に保存されます。データを複数のサーバーに分片化すると、単一サーバーの容量を超えた際に負荷を分散できます。宛先サーバーは シャーディングキー によって決まり、分散テーブルの作成時に定義されます。シャーディングキーには、ランダムな値、または hash function の出力を使用できます。シャーディングを含むデプロイメント例では、シャーディングキーとして rand() を使用し、別のシャーディングキーをいつどのように選ぶべきかについても、さらに詳しく説明します。

分散環境での協調

ClickHouse Keeperは、データのレプリケーションや分散DDLクエリの実行を支える協調システムを提供します。ClickHouse KeeperはApache ZooKeeperと互換性があります。
最終更新日 2026年6月19日