> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Configurações que restringem a complexidade das consultas.
# Restrições na complexidade das consultas
## Visão geral
Como parte das [configurações](/pt-BR/concepts/features/configuration/settings/overview), o ClickHouse oferece
a possibilidade de impor restrições à complexidade das consultas. Isso ajuda a proteger contra
consultas potencialmente intensivas em recursos, garantindo uma execução
mais segura e previsível, especialmente na interface do usuário.
Quase todas as restrições se aplicam apenas a consultas `SELECT` e, no
processamento distribuído de consultas, elas são aplicadas separadamente em cada servidor.
Em geral, o ClickHouse verifica as restrições somente depois que as partes de dados são
totalmente processadas, em vez de verificá-las para cada linha. Isso pode
levar a situações em que as restrições sejam violadas enquanto a parte está sendo
processada.
## Configurações de `overflow_mode`
A maioria das restrições também tem uma configuração `overflow_mode`, que define o que acontece
quando o limite é excedido e pode assumir um de dois valores:
* `throw`: gera uma exceção (padrão).
* `break`: interrompe a execução da consulta e retorna o resultado parcial, como se os
dados de origem tivessem se esgotado.
## Configurações de `group_by_overflow_mode`
A configuração `group_by_overflow_mode` também aceita
o valor `any`:
* `any` : continua a agregação das chaves que entraram no conjunto, mas não
adiciona novas chaves ao conjunto.
## Lista de configurações
As configurações a seguir são usadas para aplicar restrições à complexidade das consultas.
As restrições de "quantidade máxima de algo" podem ter o valor `0`,
o que significa "sem restrição".
| Configuração | Breve descrição |
| ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [`max_memory_usage`](/pt-BR/reference/settings/session-settings#max_memory_usage) | A quantidade máxima de RAM usada para executar uma consulta em um único servidor. |
| [`max_memory_usage_for_user`](/pt-BR/reference/settings/session-settings#max_memory_usage_for_user) | A quantidade máxima de RAM usada para executar as consultas de um usuário em um único servidor. |
| [`max_rows_to_read`](/pt-BR/reference/settings/session-settings#max_rows_to_read) | O número máximo de linhas que podem ser lidas de uma tabela ao executar uma consulta. |
| [`max_bytes_to_read`](/pt-BR/reference/settings/session-settings#max_bytes_to_read) | O número máximo de bytes (de dados não compactados) que podem ser lidos de uma tabela ao executar uma consulta. |
| [`read_overflow_mode_leaf`](/pt-BR/reference/settings/session-settings#read_overflow_mode_leaf) | Define o que acontece quando o volume de dados lidos excede um dos limites do nó folha |
| [`max_rows_to_read_leaf`](/pt-BR/reference/settings/session-settings#max_rows_to_read_leaf) | O número máximo de linhas que podem ser lidas de uma tabela local em um nó folha ao executar uma consulta distribuída |
| [`max_bytes_to_read_leaf`](/pt-BR/reference/settings/session-settings#max_bytes_to_read_leaf) | O número máximo de bytes (de dados não compactados) que podem ser lidos de uma tabela local em um nó folha ao executar uma consulta distribuída. |
| [`read_overflow_mode_leaf`](/pt-BR/reference/settings/session-settings#read_overflow_mode_leaf) | Define o que acontece quando o volume de dados lidos excede um dos limites do nó folha. |
| [`max_rows_to_group_by`](/pt-BR/reference/settings/session-settings#max_rows_to_group_by) | O número máximo de chaves exclusivas recebidas da agregação. |
| [`group_by_overflow_mode`](/pt-BR/reference/settings/session-settings#group_by_overflow_mode) | Define o que acontece quando o número de chaves exclusivas para agregação excede o limite |
| [`max_bytes_before_external_group_by`](/pt-BR/reference/settings/session-settings#max_bytes_before_external_group_by) | Habilita ou desabilita a execução de cláusulas `GROUP BY` em memória externa. |
| [`max_bytes_ratio_before_external_group_by`](/pt-BR/reference/settings/session-settings#max_bytes_ratio_before_external_group_by) | A proporção da memória disponível permitida para `GROUP BY`. Quando esse limite é atingido, a memória externa é usada para agregação. |
| [`max_bytes_before_external_sort`](/pt-BR/reference/settings/session-settings#max_bytes_before_external_sort) | Habilita ou desabilita a execução de cláusulas `ORDER BY` em memória externa. |
| [`max_bytes_ratio_before_external_sort`](/pt-BR/reference/settings/session-settings#max_bytes_ratio_before_external_sort) | A proporção da memória disponível permitida para `ORDER BY`. Quando esse limite é atingido, a ordenação externa é usada. |
| [`max_rows_to_sort`](/pt-BR/reference/settings/session-settings#max_rows_to_sort) | O número máximo de linhas antes da ordenação. Permite limitar o consumo de memória durante a ordenação. |
| [`max_bytes_to_sort`](/pt-BR/reference/settings/session-settings#max_rows_to_sort) | O número máximo de bytes antes da ordenação. |
| [`sort_overflow_mode`](/pt-BR/reference/settings/session-settings#sort_overflow_mode) | Define o que acontece se o número de linhas recebidas antes da ordenação exceder um dos limites. |
| [`max_result_rows`](/pt-BR/reference/settings/session-settings#max_result_rows) | Limita o número de linhas no resultado. |
| [`max_result_bytes`](/pt-BR/reference/settings/session-settings#max_result_bytes) | Limita o tamanho do resultado em bytes (não compactados) |
| [`result_overflow_mode`](/pt-BR/reference/settings/session-settings#result_overflow_mode) | Define o que fazer se o volume do resultado exceder um dos limites. |
| [`max_execution_time`](/pt-BR/reference/settings/session-settings#max_execution_time) | O tempo máximo de execução da consulta, em segundos. |
| [`timeout_overflow_mode`](/pt-BR/reference/settings/session-settings#timeout_overflow_mode) | Define o que fazer se a consulta for executada por mais tempo que `max_execution_time` ou se o tempo estimado de execução for maior que `max_estimated_execution_time`. |
| [`max_execution_time_leaf`](/pt-BR/reference/settings/session-settings#max_execution_time_leaf) | Semelhante, em termos semânticos, a `max_execution_time`, mas aplicado apenas a nós folha para consultas distribuídas ou remotas. |
| [`timeout_overflow_mode_leaf`](/pt-BR/reference/settings/session-settings#timeout_overflow_mode_leaf) | Define o que acontece quando a consulta em um nó folha é executada por mais tempo que `max_execution_time_leaf`. |
| [`min_execution_speed`](/pt-BR/reference/settings/session-settings#min_execution_speed) | Velocidade mínima de execução em linhas por segundo. |
| [`min_execution_speed_bytes`](/pt-BR/reference/settings/session-settings#min_execution_speed_bytes) | O número mínimo de bytes processados por segundo durante a execução. |
| [`max_execution_speed`](/pt-BR/reference/settings/session-settings#max_execution_speed) | O número máximo de linhas processadas por segundo durante a execução. |
| [`max_execution_speed_bytes`](/pt-BR/reference/settings/session-settings#max_execution_speed_bytes) | O número máximo de bytes processados por segundo durante a execução. |
| [`timeout_before_checking_execution_speed`](/pt-BR/reference/settings/session-settings#timeout_before_checking_execution_speed) | Verifica, após o tempo especificado em segundos, se a velocidade de execução não está muito baixa (isto é, se não é inferior a `min_execution_speed`). |
| [`max_estimated_execution_time`](/pt-BR/reference/settings/session-settings#max_estimated_execution_time) | Tempo máximo estimado de execução da consulta, em segundos. |
| [`max_columns_to_read`](/pt-BR/reference/settings/session-settings#max_columns_to_read) | O número máximo de colunas que podem ser lidas de uma tabela em uma única consulta. |
| [`max_temporary_columns`](/pt-BR/reference/settings/session-settings#max_temporary_columns) | O número máximo de colunas temporárias que devem ser mantidas na RAM simultaneamente durante a execução de uma consulta, incluindo colunas constantes. |
| [`max_temporary_non_const_columns`](/pt-BR/reference/settings/session-settings#max_temporary_non_const_columns) | O número máximo de colunas temporárias que devem ser mantidas na RAM simultaneamente durante a execução de uma consulta, sem contar as colunas constantes. |
| [`max_subquery_depth`](/pt-BR/reference/settings/session-settings#max_subquery_depth) | Define o que acontece se uma consulta tiver mais subconsultas aninhadas do que o número especificado. |
| [`max_ast_depth`](/pt-BR/reference/settings/session-settings#max_ast_depth) | A profundidade máxima de aninhamento da árvore sintática de uma consulta. |
| [`max_ast_elements`](/pt-BR/reference/settings/session-settings#max_ast_elements) | O número máximo de elementos na árvore sintática de uma consulta. |
| [`max_rows_in_set`](/pt-BR/reference/settings/session-settings#max_rows_in_set) | O número máximo de linhas de um conjunto de dados na cláusula IN criado a partir de uma subconsulta. |
| [`max_bytes_in_set`](/pt-BR/reference/settings/session-settings#max_bytes_in_set) | O número máximo de bytes (de dados não comprimidos) usados por um conjunto na cláusula IN criado a partir de uma subconsulta. |
| [`set_overflow_mode`](/pt-BR/reference/settings/session-settings#max_bytes_in_set) | Define o que acontece quando a quantidade de dados excede um dos limites. |
| [`max_rows_in_distinct`](/pt-BR/reference/settings/session-settings#max_rows_in_distinct) | O número máximo de linhas distintas ao usar DISTINCT. |
| [`max_bytes_in_distinct`](/pt-BR/reference/settings/session-settings#max_bytes_in_distinct) | O número máximo de bytes do estado (em bytes não comprimidos) na memória, usado por uma tabela hash ao usar DISTINCT. |
| [`distinct_overflow_mode`](/pt-BR/reference/settings/session-settings#distinct_overflow_mode) | Define o que acontece quando a quantidade de dados excede um dos limites. |
| [`max_rows_to_transfer`](/pt-BR/reference/settings/session-settings#max_rows_to_transfer) | Tamanho máximo (em linhas) que pode ser transferido para um servidor remoto ou salvo em uma tabela temporária quando a seção GLOBAL IN/JOIN é executada. |
| [`max_bytes_to_transfer`](/pt-BR/reference/settings/session-settings#max_bytes_to_transfer) | O número máximo de bytes (dados não comprimidos) que pode ser transferido para um servidor remoto ou salvo em uma tabela temporária quando a seção GLOBAL IN/JOIN é executada. |
| [`transfer_overflow_mode`](/pt-BR/reference/settings/session-settings#transfer_overflow_mode) | Define o que acontece quando a quantidade de dados excede um dos limites. |
| [`max_rows_in_join`](/pt-BR/reference/settings/session-settings#max_rows_in_join) | Limita o número de linhas na tabela hash usada ao fazer JOIN entre tabelas. |
| [`max_bytes_in_join`](/pt-BR/reference/settings/session-settings#max_bytes_in_join) | O tamanho máximo, em bytes, da tabela hash usada ao fazer JOIN entre tabelas. |
| [`join_overflow_mode`](/pt-BR/reference/settings/session-settings#join_overflow_mode) | Define qual ação o ClickHouse executa quando qualquer um dos limites de join a seguir é atingido. |
| [`max_partitions_per_insert_block`](/pt-BR/reference/settings/session-settings#max_partitions_per_insert_block) | Limita o número máximo de partições em um único bloco inserido, e uma exceção é lançada se o bloco contiver partições demais. |
| [`throw_on_max_partitions_per_insert_block`](/pt-BR/reference/settings/session-settings#throw_on_max_partitions_per_insert_block) | Permite controlar o comportamento quando `max_partitions_per_insert_block` é atingido. |
| [`max_temporary_data_on_disk_size_for_user`](/pt-BR/reference/settings/session-settings#throw_on_max_partitions_per_insert_block) | A quantidade máxima de dados consumida por arquivos temporários em disco, em bytes, para todas as consultas do usuário executadas concorrentemente. |
| [`max_temporary_data_on_disk_size_for_query`](/pt-BR/reference/settings/session-settings#max_temporary_data_on_disk_size_for_query) | A quantidade máxima de dados consumida por arquivos temporários em disco, em bytes, para todas as consultas executadas concorrentemente. |
| [`max_sessions_for_user`](/pt-BR/reference/settings/session-settings#max_sessions_for_user) | Número máximo de sessões simultâneas por usuário autenticado no servidor ClickHouse. |
| [`max_partitions_to_read`](/pt-BR/reference/settings/session-settings#max_partitions_to_read) | Limita o número máximo de partições que podem ser acessadas em uma única consulta. |
## Configurações obsoletas
As configurações abaixo estão obsoletas
### max\_pipeline\_depth
Profundidade máxima do pipeline. Corresponde ao número de transformações pelas quais cada
bloco de dados passa durante o processamento da consulta. A contagem é feita dentro dos limites de um
único servidor. Se a profundidade do pipeline exceder esse valor, uma exceção será lançada.