max_insert_block_size
max_insert_block_size_rows
为插入到表中而生成的块的最大大小 (按行数计) 。
此设置会在以下两种上下文中控制块的生成：
-
格式解析：当服务器通过任意接口 (HTTP、带内联数据的 clickhouse-client、gRPC、PostgreSQL wire protocol) 解析基于行的输入格式 (CSV、TSV、JSONEachRow 等) 时，会在以下情况下输出块：
- 同时达到 min_insert_block_size_rows 和 min_insert_block_size_bytes，或
- 达到 max_insert_block_size_rows 或 max_insert_block_size_bytes 中的任意一个
-
INSERT 操作：在 INSERT 查询期间，以及数据流经 materialized view 时，此设置的行为取决于
use_strict_insert_block_limits：-
启用时：会在以下情况下输出块：
- 最小阈值 (AND) ：同时达到 min_insert_block_size_rows 和 min_insert_block_size_bytes
- 最大阈值 (OR) ：达到 max_insert_block_size_rows 或 max_insert_block_size_bytes 中的任意一个
- 禁用时：当达到 min_insert_block_size_rows 或 min_insert_block_size_bytes 中的任意一个时，就会输出块。此时不会强制执行 max_insert_block_size 设置。
-
启用时：会在以下情况下输出块：
- 正整数。
max_insert_block_size_bytes
- 正整数。
- 0 — 该设置不参与块的生成。
max_insert_delayed_streams_for_parallel_write
50。
max_insert_threads
INSERT 查询时可使用的最大线程数。
这同时适用于 INSERT SELECT，以及通过
clickhouse-client 或 HTTP 接口发送数据的普通 INSERT。管道的写入端
(合并块并将其写入目标端表) 最多可由这么多线程并行处理。
可能的值：
- 0 — 自动。使用服务器可用的 CPU 核心数 (与
max_threads相同的自动值) ，并会在内存压力下通过max_insert_threads_min_free_memory_per_thread降低。 - 1 —
INSERT在单个线程中执行 (不并行执行) 。使用此值可保留INSERT ... SELECT的插入顺序。 - 大于 1 的正整数 — 使用指定数量的线程并行执行。
1 (不并行执行) 。自 26.8 起，默认值 (0) 会解析为 CPU 核心数，因此默认会并行执行 INSERT。将 max_insert_threads 设为 1 (或使用 compatibility 设置) 可恢复此前的行为。
Cloud 默认值：
- 内存为 8 GiB 的节点使用
1 - 内存为 16 GiB 的节点使用
2 - 更大规格的节点使用
4
SELECT 部分并行执行时，并行 INSERT SELECT 才会生效，参见 max_threads 设置。
对于普通 INSERT，输入数据会以单个流读取和解析，随后管道会调整为这么多个流进行写入。
写入端并行化仅适用于同步普通 INSERT：异步插入 (async_insert = 1) 会存入队列并在后台刷写，因此不受此设置影响，且始终保持单个流。
仅在安全的情况下才会并行化写入端；否则会保持单个流，此设置对其无效。具体来说，在启用 use_strict_insert_block_limits 时，如果目标端表 (或其转发到的表) 会对插入块去重，且查询已启用插入去重 (参见 deduplicate_insert) ；如果目标端具有依赖 materialized view (包括目标端转发到的表的视图，例如位于 Alias 后的视图) ——除非启用了 parallel_view_processing，且依赖视图链不存在去重风险，即视图中的去重已禁用 (deduplicate_blocks_in_dependent_materialized_views) ，或没有任何依赖视图路径能够去重；以及对于 Buffer 和 Distributed 目标端，写入都会保持单个流。Buffer 会在其自身 Context 中刷写，而 Distributed 会将写入转发到远程分片 (该分片本身可能会缓冲数据) ，因此此查询的去重设置不控制最终写入；无论这些设置如何，写入都会保持单个流。非并行 quorum 插入 (insert_quorum 为 2 或更大，或为 'auto'，且 insert_quorum_parallel 已禁用) 也会保持单个流，因为每个表只允许存在一个进行中的 quorum 分片。
值越高，内存使用量越大。
max_insert_threads_min_free_memory_per_thread
max_threads_min_free_memory_per_thread 相同，但它作用于 max_insert_threads，而不是 max_threads。默认值更高，因为插入管道通常比读取管道持有更大的单线程缓冲区 (MergeTree 分片、压缩块) 。
如果空闲内存小于 max_insert_threads 与此值的乘积，则会下调 max_insert_threads 以满足该限制，最少可降至 1。
将其设为 0 可禁用此限制。