> ## 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 max_insert_*
> Configurações de sessão do ClickHouse no grupo gerado max_insert_*.
export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
return
Tipo
{type}
Padrão
{default_value}
{changeable_without_restart &&
Pode ser alterado sem reiniciar
}
{changeable_without_restart &&
{changeable_without_restart}
}
;
};
Essas 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).
## max\_insert\_block\_size
**Aliases**: `max_insert_block_size_rows`
O tamanho máximo dos blocos (em número de 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 formatos: Quando o servidor analisa formatos de entrada baseados em linhas (CSV, TSV, JSONEachRow etc.) de qualquer interface (HTTP, clickhouse-client com dados inline, gRPC, PostgreSQL wire protocol), 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 de INSERT: Durante consultas INSERT e quando os dados fluem por visões materializadas, o comportamento dessa configuração depende de `use_strict_insert_block_limits`:
* Quando ativado: 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 desativado: 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.
## max\_insert\_block\_size\_bytes
O tamanho máximo dos blocos (em bytes) a serem formados para inserção em uma tabela.
Essa configuração funciona em conjunto com max\_insert\_block\_size\_rows e controla a formação de blocos no mesmo contexto. Consulte max\_insert\_block\_size\_rows para obter 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.
## max\_insert\_delayed\_streams\_for\_parallel\_write
O número máximo de fluxos (colunas) cujo flush final da parte pode ser atrasado. Padrão: auto (100 caso o armazenamento subjacente ofereça suporte à gravação paralela, por exemplo S3, e desabilitado caso contrário)
Valor padrão no Cloud: `50`.
## max\_insert\_threads
O número máximo de threads para executar a consulta `INSERT SELECT`.
Valores possíveis:
* 0 (ou 1) — `INSERT SELECT` sem execução em paralelo.
* Inteiro positivo, maior que 1.
Valor padrão do Cloud:
* `1` para nós com 8 GiB de memória
* `2` para nós com 16 GiB de memória
* `4` para nós maiores
O `INSERT SELECT` em paralelo só tem efeito se a parte `SELECT` for executada em paralelo; consulte a configuração [`max_threads`](/docs/pt-BR/reference/settings/session-settings/max-threads#max_threads).
Valores mais altos levam a maior uso de memória.
## max\_insert\_threads\_min\_free\_memory\_per\_thread
Igual a `max_threads_min_free_memory_per_thread`, mas aplicado a `max_insert_threads` em vez de `max_threads`. O valor padrão é mais alto porque pipelines de inserção normalmente mantêm buffers maiores por thread (partes da MergeTree, blocos de compressão) do que pipelines de leitura.
Se a quantidade de memória livre for menor que `max_insert_threads` multiplicado por esse valor, `max_insert_threads` será reduzido para se ajustar, até o mínimo de `1`.
Defina como `0` para desabilitar esse limite.