> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# max_* MergeTree 表设置

> ClickHouse MergeTree 表设置，归类于自动生成的 max_* 组。

export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
  return <div className="not-prose" style={{
    display: "flex",
    flexWrap: "wrap",
    alignItems: "baseline",
    columnGap: "0.5rem",
    rowGap: "0.125rem",
    margin: "0.375rem 0",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <div style={{
    fontWeight: 600,
    opacity: 0.72
  }}>类型</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>默认值</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          无需重启即可更改
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

这些设置见于 [system.merge\_tree\_settings](/docs/zh/reference/system-tables/merge_tree_settings)，并由 ClickHouse 源代码自动生成。

<div id="max_avg_part_size_for_too_many_parts">
  ## max\_avg\_part\_size\_for\_too\_many\_parts
</div>

<SettingsInfoBlock type="UInt64" default_value="1073741824" />

根据 'parts\_to\_delay\_insert' 和
'parts\_to\_throw\_insert' 的 'parts 过多' 检查，
只有当相关分区中的平均 part 大小不超过指定阈值时，该检查才会生效。如果平均 part 大小
大于指定阈值，则 INSERT 操作既不会被延迟，也不会被
拒绝。这样一来，如果 parts 能成功 merge 为更大的 parts，就可以在单个
server 上的单个表中存储数百 TB 的数据。这
不会影响非活跃 parts 或总 parts 数的阈值。

<div id="max_buckets_in_map">
  ## max\_buckets\_in\_map
</div>

<SettingsInfoBlock type="NonZeroUInt64" default_value="32" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.3"},{"label": "32"},{"label": "新增一个设置，用于控制 `with_buckets` Map 序列化的最大桶数"}]}]} />

`Map` 序列化的最大桶数。与 `with_buckets` `Map` 序列化一起使用。
实际桶数由 [map\_buckets\_strategy](/docs/zh/reference/settings/merge-tree-settings/map-buckets#map_buckets_strategy) 决定。
允许的最大值为 256。

<div id="max_cleanup_delay_period">
  ## max\_cleanup\_delay\_period
</div>

<SettingsInfoBlock type="UInt64" default_value="300" />

用于清理旧队列日志、块哈希和 parts 的最大周期。

<div id="max_compress_block_size">
  ## max\_compress\_block\_size
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

写入表并进行压缩前，未压缩数据块的最大大小。你也可以在全局设置中指定此设置
(参见 [max\_compress\_block\_size](/docs/zh/reference/settings/merge-tree-settings/max#max_compress_block_size)
设置) 。创建表时指定的值会覆盖此设置的全局
值。

<div id="max_concurrent_queries">
  ## max\_concurrent\_queries
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

与 MergeTree 表相关的可并发执行的查询最大数量。
查询仍会受到其他 `max_concurrent_queries` 设置的限制。

可能的值：

* 正整数。
* `0` — 不限制。

默认值：`0` (不限制) 。

**示例**

```xml theme={null}
<max_concurrent_queries>50</max_concurrent_queries>
```

<div id="max_digestion_size_per_segment">
  ## max\_digestion\_size\_per\_segment
</div>

<SettingsInfoBlock type="UInt64" default_value="268435456" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "268435456"},{"label": "已废弃"}]}]} />

已废弃设置，无任何作用。

<div id="max_file_name_length">
  ## max\_file\_name\_length
</div>

<SettingsInfoBlock type="UInt64" default_value="127" />

在不对文件名进行哈希处理的情况下，保留原文件名时允许的最大长度。
仅在启用设置 `replace_long_file_name_to_hash` 时生效。
此设置的值不包括文件扩展名的长度。因此，
建议将其设置得低于文件名最大长度 (通常为 255
字节) ，并预留一定余量，以避免文件系统错误。

<div id="max_partitions_to_read">
  ## max\_partitions\_to\_read
</div>

<SettingsInfoBlock type="Int64" default_value="-1" />

限制单次查询可访问的最大分区数。

创建表时指定的设置值可以通过
查询级别的设置覆盖。

可能的值：

* 任意正整数。

你也可以在查询 / 会话 / profile 级别指定查询复杂度设置 [max\_partitions\_to\_read](/docs/zh/reference/settings/session-settings#max_partitions_to_read)。

<div id="max_projections">
  ## max\_projections
</div>

<SettingsInfoBlock type="UInt64" default_value="25" />

MergeTree 投影的数量上限。

<div id="max_uncompressed_bytes_in_patches">
  ## max\_uncompressed\_bytes\_in\_patches
</div>

<SettingsInfoBlock type="UInt64" default_value="32212254720" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "32212254720"},{"label": "新增设置"}]}]} />

所有补丁分区片段中数据的最大未压缩大小 (字节) 。
如果所有补丁分区片段中的数据量超过该值，将拒绝轻量级更新。
0 - 不限。