使用制限

ClickHouse Cloud における組織、ウェアハウス、サービス の使用制限について説明します

ClickHouse は高速性と信頼性を追求して設計されています。最適なパフォーマンスを維持するために、推奨される運用パラメータがいくつかあります。たとえば、テーブル、データベース、パーツ が多すぎると、パフォーマンスに悪影響を及ぼす可能性があります。これを防ぐため、ClickHouse Cloud ではいくつかの運用上の次元にわたって制限を設けています。

ソフトリミットは 3 つの異なるスコープで適用されます。以下のセクションでは、ほとんどのワークロードが最初に直面する サービス レベルの制限から順に説明します。

スコープ	対象範囲	このスコープでの制限
サービス	単一の サービス とそのコンピュート	サービス ごとのコンピュート (クエリの同時実行数、バッチ取り込み) 、standalone で実行する場合のデータオブジェクト制限 (以下を参照)
ウェアハウス	1 つの ウェアハウス — 同じデータを共有する サービス のグループ	ウェアハウス 全体での合計 レプリカ、Shared Catalog 内のデータオブジェクト (テーブル、データベースなど)
Organization	ClickHouse Cloud 組織全体 (すべての ウェアハウス と サービス を合わせたもの)	サービス の数、ウェアハウス の数

データオブジェクト制限 (データベース、テーブル、カラム、パーティション、パーツ) がどのスコープで適用されるかは、サービス の運用形態によって異なります。 standalone の サービス を実行している場合、これらの制限は サービス ごとに適用されます。 サービス が ウェアハウス 内でデータを共有するようになると、同じ制限が ウェアハウス の Shared Catalog に対して一括で適用されます。 数値そのものは変わらず、測定される単位だけが変わります。

これらのガードレールに抵触した場合、ユースケースの実装が最適化されていない可能性があります。サポートまでお問い合わせください。ガードレールを超えないようユースケースを見直すお手伝いや、制御された形で上限を引き上げる方法の検討を喜んでサポートします。

​

サービス制限

以下の制限はスタンドアロンサービス (およびデータオブジェクト数については、そのサービスのストレージ) に適用されます。

サービスがウェアハウスに属している場合、データオブジェクトの制限 (データベース、テーブル、カラム、パーティション、パーツ) は、以下のウェアハウスの制限で説明するとおり、代わりにそのウェアハウスのShared Catalogに適用されます。値自体は変わりませんが、単一のサービスではなくウェアハウス全体で測定されます。クエリの同時実行数やバッチ取り込みなどのその他の制限は、いずれの場合もサービス単位 (またはレプリカ単位) のままです。

次元	制限
データベース	1000
テーブル	5000
ビュー	15000
辞書	5000
名前付きコレクション (プライベートプレビュー)	1000
カラム	~1000 (compactよりワイド形式を推奨)
パーティション	50k
パーツ	10k (max_parts_in_total設定を参照)
パーツサイズ	150 GB
低カーディナリティ	10k以下
テーブル内の主キー	データを十分に絞り込める4～5個
クエリの同時実行数	1000 (レプリカあたり)
バッチ取り込み	1M行を超えるものは1M行のブロックに分割されます

上記の値はデフォルトのガードレールです。より大規模なサービスにはより多くのヘッドルームが設定されるため、特定のサービスに適用される制限は、ここに示した値より高い場合があります。サービスに実際に適用される制限は、その上限に近づいた際に受け取る警告に記載されています。すでにこれらの制限を超えているサービスでは、テーブルおよびデータベースの制限は、サービスの現在の数に25%を加えた値に設定されます。

Single Replica Servicesでは、データベースの最大数は 100、テーブルの最大数は500に制限されます。さらに、Basic Tier Servicesの ストレージは1 TBに制限されます。上記のビュー、辞書、名前付き コレクションの制限は、Single Replica Servicesを含むすべてのサービスに 適用される共通の値です。

サービス固有の警告およびエラー制限は、system.server_settingsをクエリすることで確認できます。たとえば、

SELECT *
FROM system.server_settings
WHERE name IN ('max_table_num_to_warn', 'max_table_num_to_throw', 'max_database_num_to_warn', 'max_database_num_to_throw', 'max_view_num_to_warn', 'max_view_num_to_throw', 'max_dictionary_num_to_warn', 'max_dictionary_num_to_throw', 'max_named_collection_num_to_warn', 'max_named_collection_num_to_throw')

​

ウェアハウスの制限

ウェアハウスとは、同じデータを共有するサービスの集合です。 ウェアハウスの制限は、その共有グループ全体に対して適用されます。サービスごと、あるいは組織全体に適用されるものではありません。

項目	制限
ウェアハウスあたりのレプリカ数	50 (ソフト制限)

このレプリカ数の制限は、ウェアハウス内のすべてのサービスを合計したレプリカ数に対するものです。 ウェアハウス内のすべてのサービスは単一の ClickHouse Keeper を共有するため、この制限は Keeper の安定性を保つために設けられています。デフォルトの 50 はソフト制限であり、データやワークロードによって変動します。ClickHouse 26.6 以降では上限がより高く設定されており、今後さらに引き上げる予定です。 引き上げをご希望の場合はサポートにお問い合わせください。ウェアハウスのスケーリングの詳細については、ウェアハウスを参照してください。

On-Demand Compute には、上記の表には記載されていない個別のプライベートプレビュー対象条件および制限があります。現在の容量、同時実行数、可用性の詳細については、On-Demand Compute の制限事項を参照してください。

ウェアハウス内のサービス数そのものに対する上限はありません。上記の合計レプリカ数の制限によってのみ制約されます。

ウェアハウス内のサービスは 1 つのカタログ (同じテーブル、データベース、ビューなど) を共有するため、上記の サービスレベルのデータオブジェクト制限は、サービスごとに倍加されるのではなく、ウェアハウスごとに 1 回だけカウントされます。ウェアハウス同士は互いに分離されているため、各ウェアハウスは自身のテーブルやデータベースのみをこれらの制限の対象としてカウントします。

​

組織の制限

これらの制限は、ClickHouse Cloud の組織全体、つまりその組織に属するすべての ウェアハウス と サービス を合わせた単位で適用されます。

Dimension	Limit
組織あたりの ウェアハウス 数	制限なし
組織あたりの サービス 数	20 (ソフト制限)

組織あたりの サービス 数 の制限では、組織内の すべて の ウェアハウス に含まれる サービス が対象としてカウントされます。これはハードな上限ではなく、過去の経緯から設けられているガードレールです。サポート にお問い合わせいただければ、通常は簡単な確認のうえで引き上げが可能です。