> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 使用制限

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

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

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

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

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

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

<h2 id="service-limits">
  サービス制限
</h2>

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

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

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

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

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

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

```sql theme={null}
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')
```

<h2 id="warehouse-limits">
  ウェアハウスの制限
</h2>

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

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

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

<Note>
  On-Demand Compute には、上記の表には記載されていない個別のプライベートプレビュー対象条件および制限があります。現在の容量、同時実行数、可用性の詳細については、[On-Demand Compute の制限事項](/ja/products/cloud/features/infrastructure/on-demand-compute#limitations)を参照してください。
</Note>

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

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

<h2 id="organization-limits">
  組織の制限
</h2>

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

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

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