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

> 用于限制查询复杂度的设置。

# 查询复杂度限制

<div id="overview">
  ## 概述
</div>

作为[设置](/zh/concepts/features/configuration/settings/overview)的一部分，ClickHouse 支持
对查询复杂度施加限制。这有助于防止
查询占用过多资源，从而让执行过程
更安全、也更可预测，尤其是在使用用户界面时。

几乎所有这些限制都只适用于 `SELECT` 查询；而在分布式
查询处理场景中，这些限制会在每台服务器上分别生效。

ClickHouse 通常只会在数据分区片段
完成处理后才检查这些限制，而不是对每一行都进行检查。这可能
导致在处理分区片段期间
就已经出现超出限制的情况。

<div id="overflow_mode_setting">
  ## `overflow_mode` 设置
</div>

大多数限制也都有 `overflow_mode` 设置，用于定义
超出限制时的处理方式，可取以下两个值之一：

* `throw`：抛出异常 (默认) 。
* `break`：停止执行查询并返回部分结果，就像
  源数据已耗尽一样。

<div id="group_by_overflow_mode_settings">
  ## `group_by_overflow_mode` 设置
</div>

`group_by_overflow_mode` 设置还有
一个值 `any`：

* `any`：继续对已进入该集合的键进行聚合，但不再
  将新键添加到该集合中。

<div id="relevant-settings">
  ## 设置列表
</div>

以下设置用于实施查询复杂度限制。

<Note>
  对“某项内容的最大值”的限制可以设为 `0`，
  这表示其“不受限制”。
</Note>

| 设置项                                                                                                                              | 简要说明                                                                              |
| -------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| [`max_memory_usage`](/zh/reference/settings/session-settings#max_memory_usage)                                                   | 在单台服务器上运行查询时可使用的最大 RAM 量。                                                         |
| [`max_memory_usage_for_user`](/zh/reference/settings/session-settings#max_memory_usage_for_user)                                 | 在单台服务器上运行用户查询时可使用的最大 RAM 量。                                                       |
| [`max_rows_to_read`](/zh/reference/settings/session-settings#max_rows_to_read)                                                   | 运行查询时可从表中读取的最大行数。                                                                 |
| [`max_bytes_to_read`](/zh/reference/settings/session-settings#max_bytes_to_read)                                                 | 运行查询时可从表中读取的最大字节数 (未压缩数据) 。                                                       |
| [`read_overflow_mode_leaf`](/zh/reference/settings/session-settings#read_overflow_mode_leaf)                                     | 设置当读取的数据量超过某个叶子节点限制时的处理方式。                                                        |
| [`max_rows_to_read_leaf`](/zh/reference/settings/session-settings#max_rows_to_read_leaf)                                         | 运行分布式查询时，可从叶子节点上的本地表读取的最大行数。                                                      |
| [`max_bytes_to_read_leaf`](/zh/reference/settings/session-settings#max_bytes_to_read_leaf)                                       | 运行分布式查询时，可从叶子节点上的本地表读取的最大字节数 (未压缩数据) 。                                            |
| [`read_overflow_mode_leaf`](/zh/reference/settings/session-settings#read_overflow_mode_leaf)                                     | 设置当读取的数据量超过某个叶子节点限制时的处理方式。                                                        |
| [`max_rows_to_group_by`](/zh/reference/settings/session-settings#max_rows_to_group_by)                                           | 聚合产生的唯一键的最大数量。                                                                    |
| [`group_by_overflow_mode`](/zh/reference/settings/session-settings#group_by_overflow_mode)                                       | 设置当聚合的唯一键数量超过限制时的处理方式。                                                            |
| [`max_bytes_before_external_group_by`](/zh/reference/settings/session-settings#max_bytes_before_external_group_by)               | 启用或禁用在外部内存中执行 `GROUP BY` 子句。                                                      |
| [`max_bytes_ratio_before_external_group_by`](/zh/reference/settings/session-settings#max_bytes_ratio_before_external_group_by)   | `GROUP BY` 可使用的可用内存比例。达到该比例后，将使用外部内存进行聚合。                                         |
| [`max_bytes_before_external_sort`](/zh/reference/settings/session-settings#max_bytes_before_external_sort)                       | 启用或禁用在外部内存中执行 `ORDER BY` 子句。                                                      |
| [`max_bytes_ratio_before_external_sort`](/zh/reference/settings/session-settings#max_bytes_ratio_before_external_sort)           | `ORDER BY` 可使用的可用内存比例。达到该比例后，将使用外部排序。                                             |
| [`max_rows_to_sort`](/zh/reference/settings/session-settings#max_rows_to_sort)                                                   | 排序前允许的最大行数。可用于限制排序时的内存消耗。                                                         |
| [`max_bytes_to_sort`](/zh/reference/settings/session-settings#max_rows_to_sort)                                                  | 排序前允许的最大字节数。                                                                      |
| [`sort_overflow_mode`](/zh/reference/settings/session-settings#sort_overflow_mode)                                               | 设置当排序前接收的行数超过某个限制时的处理方式。                                                          |
| [`max_result_rows`](/zh/reference/settings/session-settings#max_result_rows)                                                     | 限制结果中的行数。                                                                         |
| [`max_result_bytes`](/zh/reference/settings/session-settings#max_result_bytes)                                                   | 限制结果大小 (按字节计，未压缩) 。                                                               |
| [`result_overflow_mode`](/zh/reference/settings/session-settings#result_overflow_mode)                                           | 设置当结果数据量超过某个限制时的处理方式。                                                             |
| [`max_execution_time`](/zh/reference/settings/session-settings#max_execution_time)                                               | 查询执行时间上限，以秒为单位。                                                                   |
| [`timeout_overflow_mode`](/zh/reference/settings/session-settings#timeout_overflow_mode)                                         | 设置当查询运行时间超过 `max_execution_time`，或预估运行时间超过 `max_estimated_execution_time` 时的处理方式。 |
| [`max_execution_time_leaf`](/zh/reference/settings/session-settings#max_execution_time_leaf)                                     | 在语义上与 `max_execution_time` 类似，但仅适用于分布式或远程查询中的叶子节点。                                |
| [`timeout_overflow_mode_leaf`](/zh/reference/settings/session-settings#timeout_overflow_mode_leaf)                               | 设置当叶子节点上的查询运行时间超过 `max_execution_time_leaf` 时的处理方式。                               |
| [`min_execution_speed`](/zh/reference/settings/session-settings#min_execution_speed)                                             | 最低执行速度，以每秒行数计。                                                                    |
| [`min_execution_speed_bytes`](/zh/reference/settings/session-settings#min_execution_speed_bytes)                                 | 最低执行速度，以每秒字节数计。                                                                   |
| [`max_execution_speed`](/zh/reference/settings/session-settings#max_execution_speed)                                             | 最高执行速度，以每秒行数计。                                                                    |
| [`max_execution_speed_bytes`](/zh/reference/settings/session-settings#max_execution_speed_bytes)                                 | 最高执行速度，以每秒字节数计。                                                                   |
| [`timeout_before_checking_execution_speed`](/zh/reference/settings/session-settings#timeout_before_checking_execution_speed)     | 在指定秒数过去后，检查执行速度是否过慢 (不低于 `min_execution_speed`) 。                                 |
| [`max_estimated_execution_time`](/zh/reference/settings/session-settings#max_estimated_execution_time)                           | 查询预估执行时间上限，以秒为单位。                                                                 |
| [`max_columns_to_read`](/zh/reference/settings/session-settings#max_columns_to_read)                                             | 单个查询可从一张表中读取的最大列数。                                                                |
| [`max_temporary_columns`](/zh/reference/settings/session-settings#max_temporary_columns)                                         | 运行查询时必须同时保存在 RAM 中的临时列的最大数量，包括常量列。                                                |
| [`max_temporary_non_const_columns`](/zh/reference/settings/session-settings#max_temporary_non_const_columns)                     | 运行查询时必须同时保存在 RAM 中的临时列的最大数量，但不包括常量列。                                              |
| [`max_subquery_depth`](/zh/reference/settings/session-settings#max_subquery_depth)                                               | 设置当查询中的嵌套子查询数量超过指定值时的处理方式。                                                        |
| [`max_ast_depth`](/zh/reference/settings/session-settings#max_ast_depth)                                                         | 查询语法树的最大嵌套深度。                                                                     |
| [`max_ast_elements`](/zh/reference/settings/session-settings#max_ast_elements)                                                   | 查询语法树中的最大元素数量。                                                                    |
| [`max_rows_in_set`](/zh/reference/settings/session-settings#max_rows_in_set)                                                     | 由子查询创建的 IN 子句中数据集的最大行数。                                                           |
| [`max_bytes_in_set`](/zh/reference/settings/session-settings#max_bytes_in_set)                                                   | 由子查询创建的 IN 子句中集合可使用的最大字节数 (未压缩数据) 。                                               |
| [`set_overflow_mode`](/zh/reference/settings/session-settings#max_bytes_in_set)                                                  | 设置当数据量超过某个限制时的处理方式。                                                               |
| [`max_rows_in_distinct`](/zh/reference/settings/session-settings#max_rows_in_distinct)                                           | 使用 DISTINCT 时不同行的最大数量。                                                            |
| [`max_bytes_in_distinct`](/zh/reference/settings/session-settings#max_bytes_in_distinct)                                         | 使用 DISTINCT 时，内存中由哈希表使用的状态的最大字节数 (按未压缩字节计) 。                                      |
| [`distinct_overflow_mode`](/zh/reference/settings/session-settings#distinct_overflow_mode)                                       | 设置当数据量超过某个限制时的处理方式。                                                               |
| [`max_rows_to_transfer`](/zh/reference/settings/session-settings#max_rows_to_transfer)                                           | 执行 GLOBAL IN/JOIN 子句时，可传递到远程服务器或保存到临时表中的最大大小 (以行为单位) 。                            |
| [`max_bytes_to_transfer`](/zh/reference/settings/session-settings#max_bytes_to_transfer)                                         | 执行 GLOBAL IN/JOIN 子句时，可传递到远程服务器或保存到临时表中的最大字节数 (未压缩数据) 。                           |
| [`transfer_overflow_mode`](/zh/reference/settings/session-settings#transfer_overflow_mode)                                       | 设置当数据量超过某个限制时的处理方式。                                                               |
| [`max_rows_in_join`](/zh/reference/settings/session-settings#max_rows_in_join)                                                   | 限制表连接时所使用哈希表中的最大行数。                                                               |
| [`max_bytes_in_join`](/zh/reference/settings/session-settings#max_bytes_in_join)                                                 | 限制表连接时所使用哈希表的最大大小 (按字节数计) 。                                                       |
| [`join_overflow_mode`](/zh/reference/settings/session-settings#join_overflow_mode)                                               | 定义达到以下任一 join 限制时 ClickHouse 会执行的操作。                                              |
| [`max_partitions_per_insert_block`](/zh/reference/settings/session-settings#max_partitions_per_insert_block)                     | 限制单个插入块中的最大分区数；如果块中包含过多分区，则会抛出异常。                                                 |
| [`throw_on_max_partitions_per_insert_block`](/zh/reference/settings/session-settings#throw_on_max_partitions_per_insert_block)   | 允许控制达到 `max_partitions_per_insert_block` 时的行为。                                    |
| [`max_temporary_data_on_disk_size_for_user`](/zh/reference/settings/session-settings#throw_on_max_partitions_per_insert_block)   | 所有并发运行的用户查询在磁盘上由临时 File 消耗的最大数据量 (以字节为单位) 。                                       |
| [`max_temporary_data_on_disk_size_for_query`](/zh/reference/settings/session-settings#max_temporary_data_on_disk_size_for_query) | 所有并发运行的查询在磁盘上由临时 File 消耗的最大数据量 (以字节为单位) 。                                         |
| [`max_sessions_for_user`](/zh/reference/settings/session-settings#max_sessions_for_user)                                         | 每个已认证用户连接到 ClickHouse 服务器的最大并发会话数。                                                |
| [`max_partitions_to_read`](/zh/reference/settings/session-settings#max_partitions_to_read)                                       | 限制单个查询中可访问的最大分区数。                                                                 |

<div id="obsolete-settings">
  ## 已废弃的设置
</div>

<Note>
  以下设置已废弃
</Note>

<div id="max-pipeline-depth">
  ### max\_pipeline\_depth
</div>

最大管道深度。它表示每个
数据块在查询处理过程中经历的转换次数。该值是在单个
服务器的限制范围内计算的。如果管道深度超过该值，则会抛出异常。