Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

configurações de sessão min_insert_*

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

Tipo
UInt64
Padrão
268402944

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

Tipo
UInt64
Padrão
0

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

Tipo
UInt64
Padrão
1048449

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

Tipo
UInt64
Padrão
0

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

Navigation