ClickHouse/docs/ja/operations/settings/query-complexity.md

---
machine_translated: true
machine_translated_rev: d734a8e46ddd7465886ba4133bff743c55190626
toc_priority: 59
toc_title: "\u30AF\u30A8\u30EA\u306E\u8907\u96D1\u3055\u306E\u5236\u9650"
---

# クエリの複雑さの制限 {#restrictions-on-query-complexity}

クエリの複雑さの制限は、設定の一部です。
これらをより安全な実行のユーザーインターフェースです。
ほぼすべての制限が適用されます `SELECT`. 分散クエリ処理では、各サーバーに個別に制限が適用されます。

ClickHouseは、各行ではなく、データパーツの制限をチェックします。 これは、データ部分のサイズで制限の値を超えることができることを意味します。

の制限 “maximum amount of something” 値0を取ることができます。 “unrestricted”.
ほとんどの制限には、 ‘overflow\_mode’ 設定、制限を超えたときに何をすべきかを意味します。
それは二つの値のいずれか: `throw` または `break`. 集計の制限(group\_by\_overflow\_mode)にも値があります `any`.

`throw` – Throw an exception (default).

`break` – Stop executing the query and return the partial result, as if the source data ran out.

`any (only for group_by_overflow_mode)` – Continuing aggregation for the keys that got into the set, but don’t add new keys to the set.

## max\_memory\_usage {#settings_max_memory_usage}

単一のサーバーでクエリを実行するために使用するramの最大量。

デフォルトの設定ファイルでは、最大値は10gbです。

この設定では、使用可能なメモリの量やマシン上のメモリの総量は考慮されません。
この制限は、単一のサーバー内の単一のクエリに適用されます。
を使用することができ `SHOW PROCESSLIST` 各クエリの現在のメモリ消費量を表示します。
さらに、各クエリに対してピークのメモリ消費が追跡され、ログに書き込まれます。

特定の集計関数の状態に対するメモリ使用量は監視されません。

集計関数の状態に対するメモリ使用量は完全には追跡されません `min`, `max`, `any`, `anyLast`, `argMin`, `argMax` から `String` と `Array` 引数。

メモリ消費もパラメータによって制限されます `max_memory_usage_for_user` と `max_memory_usage_for_all_queries`.

## max\_memory\_usage\_for\_user {#max-memory-usage-for-user}

単一のサーバー上でユーザーのクエリを実行するために使用するramの最大量。

デフォルト値は [設定。h](https://github.com/ClickHouse/ClickHouse/blob/master/dbms/Core/Settings.h#L288). デフォルトでは、金額は制限されません (`max_memory_usage_for_user = 0`).

の説明も参照してください [max\_memory\_usage](#settings_max_memory_usage).

## max\_memory\_usage\_for\_all\_queries {#max-memory-usage-for-all-queries}

単一のサーバー上ですべてのクエリを実行するために使用するramの最大量。

デフォルト値は [設定。h](https://github.com/ClickHouse/ClickHouse/blob/master/dbms/Core/Settings.h#L289). デフォルトでは、金額は制限されません (`max_memory_usage_for_all_queries = 0`).

の説明も参照してください [max\_memory\_usage](#settings_max_memory_usage).

## max\_rows\_to\_read {#max-rows-to-read}

各行ではなく、各ブロックで次の制限を確認できます。 つまり、制限は少し壊れる可能性があります。
複数のスレッドでクエリを実行する場合、次の制限が各スレッドに個別に適用されます。

クエリの実行時にテーブルから読み取ることができる最大行数。

## max\_bytes\_to\_read {#max-bytes-to-read}

クエリの実行時にテーブルから読み取ることができる最大バイト数(圧縮されていないデータ)。

## read\_overflow\_mode {#read-overflow-mode}

データの読み取り量がいずれかの制限を超えた場合の対処方法: ‘throw’ または ‘break’. デフォルトでは、投げる。

## max\_rows\_to\_group\_by {#settings-max-rows-to-group-by}

集約から受け取った一意のキーの最大数。 この設定では、集計時のメモリ消費量を制限できます。

## group\_by\_overflow\_mode {#group-by-overflow-mode}

集計の一意のキーの数が制限を超えた場合の対処方法: ‘throw’, ‘break’、または ‘any’. デフォルトでは、投げる。
を使用して ‘any’ valueを使用すると、GROUP BYの近似を実行できます。 この近似の品質は、データの統計的性質に依存します。

## max\_bytes\_before\_external\_group\_by {#settings-max_bytes_before_external_group_by}

の実行を有効または無効にします。 `GROUP BY` 外部メモリ内の句。 見る [外部メモリによるグループ化](../../sql-reference/statements/select.md#select-group-by-in-external-memory).

可能な値:

-   シングルで使用できるramの最大ボリューム(バイト単位)。 [GROUP BY](../../sql-reference/statements/select.md#select-group-by-clause) オペレーション
-   0 — `GROUP BY` 外部メモリで無効。

デフォルト値:0.

## max\_rows\_to\_sort {#max-rows-to-sort}

並べ替え前の行の最大数。 これにより、ソート時のメモリ消費量を制限できます。

## max\_bytes\_to\_sort {#max-bytes-to-sort}

ソート前の最大バイト数。

## sort\_overflow\_mode {#sort-overflow-mode}

ソート前に受け取った行の数がいずれかの制限を超えた場合の対処方法: ‘throw’ または ‘break’. デフォルトでは、投げる。

## max\_result\_rows {#setting-max_result_rows}

結果の行数を制限します。 またチェックサブクエリは、windowsアプリケーションの実行時にパーツの分散を返します。

## max\_result\_bytes {#max-result-bytes}

結果のバイト数を制限します。 前の設定と同じです。

## result\_overflow\_mode {#result-overflow-mode}

結果のボリュームがいずれかの制限を超えた場合の対処方法: ‘throw’ または ‘break’. デフォルトでは、投げる。

を使用して ‘break’ LIMITを使用するのと似ています。 `Break` ブロックレベルでのみ実行を中断します。 これは、返される行の量が [max\_result\_rows](#setting-max_result_rows)、の倍数 [max\_block\_size](settings.md#setting-max_block_size) そして依存します [max\_threads](settings.md#settings-max_threads).

例えば:

``` sql
SET max_threads = 3, max_block_size = 3333;
SET max_result_rows = 3334, result_overflow_mode = 'break';

SELECT *
FROM numbers_mt(100000)
FORMAT Null;
```

結果:

``` text
6666 rows in set. ...
```

## max\_execution\_time {#max-execution-time}

クエリの最大実行時間(秒)。
このとき、ソート段階のいずれか、または集計関数のマージおよびファイナライズ時にはチェックされません。

## timeout\_overflow\_mode {#timeout-overflow-mode}

クエリがより長く実行される場合の対処方法 ‘max\_execution\_time’: ‘throw’ または ‘break’. デフォルトでは、投げる。

## min\_execution\_speed {#min-execution-speed}

毎秒行の最小の実行速度。 チェックすべてのデータブロックの場合 ‘timeout\_before\_checking\_execution\_speed’ 期限が切れる 実行速度が遅い場合は、例外がスローされます。

## min\_execution\_speed\_bytes {#min-execution-speed-bytes}

実行バイト/秒の最小数。 チェックすべてのデータブロックの場合 ‘timeout\_before\_checking\_execution\_speed’ 期限が切れる 実行速度が遅い場合は、例外がスローされます。

## max\_execution\_speed {#max-execution-speed}

秒あたりの実行行の最大数。 チェックすべてのデータブロックの場合 ‘timeout\_before\_checking\_execution\_speed’ 期限が切れる 実行速度が速い場合、実行速度が低下します。

## max\_execution\_speed\_bytes {#max-execution-speed-bytes}

実行バイト/秒の最大数。 チェックすべてのデータブロックの場合 ‘timeout\_before\_checking\_execution\_speed’ 期限が切れる 実行速度が速い場合、実行速度が低下します。

## timeout\_before\_checking\_execution\_speed {#timeout-before-checking-execution-speed}

実行速度が遅すぎないことをチェックする ‘min\_execution\_speed’指定された時間が経過した後、秒で）。

## max\_columns\_to\_read {#max-columns-to-read}

単一のクエリでテーブルから読み取ることができる列の最大数。 クエリでより多くの列を読み取る必要がある場合は、例外がスローされます。

## max\_temporary\_columns {#max-temporary-columns}

定数の列を含む、クエリを実行するときにramに同時に保持する必要がある一時的な列の最大数。 これよりも一時的な列が多い場合は、例外がスローされます。

## max\_temporary\_non\_const\_columns {#max-temporary-non-const-columns}

同じものとして ‘max\_temporary\_columns’ しかし、一定の列を数えずに。
定数の列は、クエリを実行するときにかなり頻繁に形成されますが、計算リソースはほぼゼロになります。

## max\_subquery\_depth {#max-subquery-depth}

サブクエリの最大ネスト深度。 サブクエリが深い場合は、例外がスローされます。 デフォルトでは、100。

## max\_pipeline\_depth {#max-pipeline-depth}

パイプラインの最大深さ。 クエリ処理中に各データブロックが通過する変換の数に対応します。 単一のサーバーの制限内で数えられます。 パイプラインの深さが大きい場合は、例外がスローされます。 デフォルトでは、1000。

## max\_ast\_depth {#max-ast-depth}

クエリ構文ツリーの最大ネスト深さ。 超過すると、例外がスローされます。
現時点では、解析中にチェックされず、クエリを解析した後でのみチェックされます。 つまり、構文解析中に深すぎる構文木を作成することはできますが、クエリは失敗します。 デフォルトでは、1000。

## max\_ast\_elements {#max-ast-elements}

クエリ構文ツリー内の要素の最大数。 超過すると、例外がスローされます。
以前の設定と同じように、クエリを解析した後にのみチェックされます。 デフォルトでは、50,000。

## max\_rows\_in\_set {#max-rows-in-set}

サブクエリから作成されたin句のデータ-セットの最大行数。

## max\_bytes\_inset {#max-bytes-in-set}

サブクエリから作成されたin句のセットによって使用される最大バイト数(圧縮されていないデータ)。

## set\_overflow\_mode {#set-overflow-mode}

データの量がいずれかの制限を超えた場合の対処方法: ‘throw’ または ‘break’. デフォルトでは、投げる。

## max\_rows\_in\_distinct {#max-rows-in-distinct}

DISTINCTを使用する場合の異なる行の最大数。

## max\_bytes\_in\_distinct {#max-bytes-in-distinct}

DISTINCTを使用するときにハッシュテーブルで使用される最大バイト数。

## distinct\_overflow\_mode {#distinct-overflow-mode}

データの量がいずれかの制限を超えた場合の対処方法: ‘throw’ または ‘break’. デフォルトでは、投げる。

## max\_rows\_tokenトランスファー {#max-rows-to-transfer}

リモートサーバーに渡すか、global inを使用するときに一時テーブルに保存できる行の最大数。

## max\_bytes\_to\_transfer {#max-bytes-to-transfer}

リモートサーバーに渡すか、global inを使用するときに一時テーブルに保存できる最大バイト数(圧縮されていないデータ)。

## transfer\_overflow\_mode {#transfer-overflow-mode}

データの量がいずれかの制限を超えた場合の対処方法: ‘throw’ または ‘break’. デフォルトでは、投げる。

## max\_rows\_in\_join {#settings-max_rows_in_join}

テーブルを結合するときに使用されるハッシュテーブルの行数を制限します。

この設定は以下に適用されます [SELECT … JOIN](../../sql-reference/statements/select.md#select-join) 業務の [参加](../../engines/table-engines/special/join.md) テーブルエンジン。

クエリに複数の結合が含まれている場合、clickhouseは中間結果ごとにこの設定をチェックします。

ClickHouseは、制限に達したときにさまざまなアクションを実行できます。 を使用 [join\_overflow\_mode](#settings-join_overflow_mode) アクションを選択する設定。

可能な値:

-   正の整数。
-   0 — Unlimited number of rows.

デフォルト値:0.

## max\_bytes\_in\_join {#settings-max_bytes_in_join}

制限サイズをバイトのハッシュテーブルが参加す。

この設定は以下に適用されます [SELECT … JOIN](../../sql-reference/statements/select.md#select-join) 操作と [結合テーブルエンジン](../../engines/table-engines/special/join.md).

クエリに結合が含まれている場合、clickhouseは中間結果ごとにこの設定をチェックします。

ClickHouseは、制限に達したときにさまざまなアクションを実行できます。 使用 [join\_overflow\_mode](#settings-join_overflow_mode) アクションを選択するための設定。

可能な値:

-   正の整数。
-   0 — Memory control is disabled.

デフォルト値:0.

## join\_overflow\_mode {#settings-join_overflow_mode}

次の結合制限のいずれかに達したときにclickhouseが実行するアクションを定義します:

-   [max\_bytes\_in\_join](#settings-max_bytes_in_join)
-   [max\_rows\_in\_join](#settings-max_rows_in_join)

可能な値:

-   `THROW` — ClickHouse throws an exception and breaks operation.
-   `BREAK` — ClickHouse breaks operation and doesn’t throw an exception.

デフォルト値: `THROW`.

**また見なさい**

-   [JOIN句](../../sql-reference/statements/select.md#select-join)
-   [結合テーブルエンジン](../../engines/table-engines/special/join.md)

## max\_partitions\_per\_insert\_block {#max-partitions-per-insert-block}

単一の挿入ブロック内のパーティションの最大数を制限します。

-   正の整数。
-   0 — Unlimited number of partitions.

デフォルト値:100。

**詳細**

を挿入する際、データclickhouse計算パーティションの数に挿入されます。 パーティションの数が `max_partitions_per_insert_block`、ClickHouseは、次のテキストで例外をスローします:

> “Too many partitions for single INSERT block (more than” +toString(max\_parts)+ “). The limit is controlled by ‘max\_partitions\_per\_insert\_block’ setting. A large number of partitions is a common misconception. It will lead to severe negative performance impact, including slow server startup, slow INSERT queries and slow SELECT queries. Recommended total number of partitions for a table is under 1000..10000. Please note, that partitioning is not intended to speed up SELECT queries (ORDER BY key is sufficient to make range queries fast). Partitions are intended for data manipulation (DROP PARTITION, etc).”

[元の記事](https://clickhouse.tech/docs/en/operations/settings/query_complexity/) <!--hide-->