Skip to main content
Estas configurações estão disponíveis em system.settings e são geradas automaticamente a partir do código-fonte.

​
min_insert_block_size_bytes

O tamanho mínimo dos blocos (em bytes) a serem formados para inserção em uma tabela. Essa configuração funciona em conjunto com min_insert_block_size_rows e controla a formação de blocos nos mesmos contextos (análise de formato e operações INSERT). Consulte min_insert_block_size_rows para informações detalhadas sobre quando e como essas configurações são aplicadas. Valores possíveis:
  • Inteiro positivo.
  • 0 — a configuração não participa da formação de blocos.

​
min_insert_block_size_bytes_for_materialized_views

Define a quantidade mínima de bytes no bloco que pode ser inserido em uma tabela por uma consulta INSERT. Blocos menores são agrupados em blocos maiores. Essa configuração se aplica apenas aos blocos inseridos em visão materializada. Ao ajustar essa configuração, você controla o agrupamento de blocos ao enviar para a visão materializada e evita uso excessivo de memória. Valores possíveis:
  • Qualquer inteiro positivo.
  • 0 — Agrupamento desabilitado.
Veja também

​
min_insert_block_size_rows

O tamanho mínimo dos blocos (em linhas) a serem formados para inserção em uma tabela. Essa configuração controla a formação de blocos em dois contextos:
  1. Análise de formato: quando o servidor analisa formatos de entrada baseados em linhas (CSV, TSV, JSONEachRow etc.) de qualquer interface (HTTP, clickhouse-client com dados inline, gRPC, protocolo wire do PostgreSQL), os blocos são emitidos quando:
    • Ambos min_insert_block_size_rows AND min_insert_block_size_bytes são atingidos, OR
    • max_insert_block_size_rows OR max_insert_block_size_bytes é atingido
    Observação: ao usar clickhouse-client ou clickhouse-local para ler de um arquivo, o próprio cliente analisa os dados, e essa configuração se aplica no lado do cliente.
  2. Operações INSERT: durante consultas INSERT e quando os dados passam por visões materializadas, o comportamento dessa configuração depende de use_strict_insert_block_limits:
    • Quando habilitado: os blocos são emitidos quando:
      • Limiares mínimos (AND): ambos min_insert_block_size_rows AND min_insert_block_size_bytes são atingidos
      • Limiares máximos (OR): max_insert_block_size_rows OR max_insert_block_size_bytes é atingido
    • Quando desabilitado (padrão): os blocos são emitidos quando min_insert_block_size_rows OR min_insert_block_size_bytes é atingido. As configurações max_insert_block_size não são aplicadas.
Valores possíveis:
  • Inteiro positivo.
  • 0 — a configuração não participa da formação de blocos.

​
min_insert_block_size_rows_for_materialized_views

Define o número mínimo de linhas em um bloco que pode ser inserido em uma tabela por uma consulta INSERT. Blocos menores são agrupados em blocos maiores. Essa configuração se aplica apenas a blocos inseridos em visão materializada. Ao ajustar essa configuração, você controla o agrupamento de blocos ao enviar para a visão materializada e evita o uso excessivo de memória. Valores possíveis:
  • Qualquer inteiro positivo.
  • 0 — Agrupamento desabilitado.
Veja também
Última modificação em 23 de julho de 2026