使用制限 - ClickHouse Documentation

ClickHouse はその高速性と信頼性で知られていますが、最適なパフォーマンスを得るには一定の運用条件を満たす必要があります。たとえば、テーブル、データベース、パーツが多すぎると、パフォーマンスに悪影響を及ぼす可能性があります。これを防ぐため、ClickHouse Cloud では複数の運用面にわたって制限を設けています。これらのガードレールの詳細を以下に示します。これはデフォルト値を示しています。

これらのガードレールのいずれかに達している場合は、ユースケースの実装が十分に最適化されていない可能性があります。サポートチームまでご連絡ください。ガードレールを超えないようユースケースを改善するお手伝いを喜んで行います。また、必要に応じて、制限を適切に引き上げる方法についても一緒に検討できます。

Dimension	Limit
Databases	1000
Tables	5000
Columns	∼1000 (compact よりワイド形式を推奨)
Partitions	50k
Parts	10k (`max_parts_in_total` 設定を参照)
Part size	150 GB
Services per organization	20 (ソフト制限)
Services per warehouse	5 (ソフト制限)
Replicas per service	20 (ソフト制限)
Low cardinality	10k 以下
Primary keys in a table	データを十分に絞り込める 4～5 個
Query concurrency	1000 (レプリカごと)
Batch ingest	1M を超えるものは、システムによって 100 万行単位のブロックに分割されます

Single Replica Services の場合、データベースの最大数は 100、テーブルの最大数は 500 に制限されます。さらに、Basic ティアのサービスのストレージは 1 TB に制限されます。

すでに上記の使用制限を超えているサービスについては、テーブル数/データベース数の制限は、そのサービスの現在のテーブル数/データベース数に 25% を加えた値に設定されます。

サービス固有の warn 制限および throw 制限は、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')

最終更新日 2026年7月23日

Cloud との互換性このガイドでは、ClickHouse Cloud の機能面および運用面で想定される違いの概要を説明します。