> ## 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.

# configurações de sessão min_insert_*

> Configurações de sessão do ClickHouse pertencentes ao grupo gerado min_insert_*.

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
  }}>Tipo</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>Padrão</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          Pode ser alterado sem reiniciar
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

Estas configurações estão disponíveis em [system.settings](/docs/pt-BR/reference/system-tables/settings) e são geradas automaticamente a partir do [código-fonte](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).

<div id="min_insert_block_size_bytes">
  ## min\_insert\_block\_size\_bytes
</div>

<SettingsInfoBlock type="UInt64" default_value="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.

<div id="min_insert_block_size_bytes_for_materialized_views">
  ## min\_insert\_block\_size\_bytes\_for\_materialized\_views
</div>

<SettingsInfoBlock type="UInt64" default_value="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](/docs/pt-BR/reference/statements/create/view). 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\_bytes](/docs/pt-BR/reference/settings/session-settings/min-insert#min_insert_block_size_bytes)

<div id="min_insert_block_size_rows">
  ## min\_insert\_block\_size\_rows
</div>

<SettingsInfoBlock type="UInt64" default_value="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.

<div id="min_insert_block_size_rows_for_materialized_views">
  ## min\_insert\_block\_size\_rows\_for\_materialized\_views
</div>

<SettingsInfoBlock type="UInt64" default_value="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](/docs/pt-BR/reference/statements/create/view). 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**

* [min\_insert\_block\_size\_rows](/docs/pt-BR/reference/settings/session-settings/min-insert#min_insert_block_size_rows)