Skip to main content
这些设置可在 system.settings 中查看，并根据 源代码 自动生成。

​
min_insert_block_size_bytes

插入到表时生成的块的最小大小 (以字节为单位) 。 此设置与 min_insert_block_size_rows 配合使用，并在相同的上下文中控制块的生成 (格式解析和 INSERT 操作) 。有关这些设置会在何时以及如何应用的详细信息，请参见 min_insert_block_size_rows。 可能的值：
  • 正整数。
  • 0 — 该设置不参与块的生成。

​
min_insert_block_size_bytes_for_materialized_views

设置可通过 INSERT 查询插入到表中的块的最小字节数。较小的块会合并为更大的块。此设置仅适用于插入到 materialized view 的块。通过调整此设置，你可以控制推送到 materialized view 时的块合并，并避免过高的内存占用。 可能的值：
  • 任意正整数。
  • 0 — 禁用合并。
另请参见

​
min_insert_block_size_rows

插入表时生成的块的最小大小 (按行数计) 。 此设置控制以下两种场景中的块的生成：
  1. 格式解析：当服务器通过任意接口 (HTTP、带内联数据的 ClickHouse 客户端、gRPC、PostgreSQL wire protocol) 解析基于行的输入格式 (CSV、TSV、JSONEachRow 等) 时，会在以下情况下输出块：
    • 同时达到 min_insert_block_size_rows AND min_insert_block_size_bytes，OR
    • 达到 max_insert_block_size_rows OR max_insert_block_size_bytes 其中之一
    注意：使用 ClickHouse 客户端 或 clickhouse-local 从文件读取时，数据由客户端自身解析，因此此设置在客户端生效。
  2. INSERT 操作：在 INSERT 查询期间以及数据流经 materialized view 时，此设置的行为取决于 use_strict_insert_block_limits：
    • 启用时：会在以下情况下输出块：
      • 最小阈值 (AND) ：同时达到 min_insert_block_size_rows AND min_insert_block_size_bytes
      • 最大阈值 (OR) ：达到 max_insert_block_size_rows OR max_insert_block_size_bytes 其中之一
    • 禁用时 (默认) ：当达到 min_insert_block_size_rows OR min_insert_block_size_bytes 其中之一时就会输出块。此时不会强制执行 max_insert_block_size 设置。
可能的值：
  • 正整数。
  • 0 — 此设置不参与块的生成。

​
min_insert_block_size_rows_for_materialized_views

设置可通过 INSERT 查询插入到表中的块的最小行数。较小的块会合并为更大的块。此设置仅适用于插入到 materialized view 的块。调整此设置后，您可以控制推送到 materialized view 时的块合并，从而避免过高的内存占用。 可能的值：
  • 任意正整数。
  • 0 — 禁用合并。
另请参阅
最后修改于 2026年7月23日