` se o arquivo tiver a extensão correta.
## allow\_asynchronous\_read\_from\_io\_pool\_for\_merge\_tree
Usa o pool de E/S em segundo plano para ler dados de tabelas MergeTree. Essa configuração pode aumentar o desempenho de consultas limitadas por E/S.
## allow\_calculating\_subcolumns\_sizes\_for\_merge\_tree\_reading
Quando habilitada, o ClickHouse calculará o tamanho dos arquivos necessários para a leitura de cada subcoluna para melhorar o cálculo dos tamanhos das tarefas e dos blocos.
## allow\_changing\_replica\_until\_first\_data\_packet
Se estiver habilitado, em hedged requests podemos iniciar uma nova conexão até receber o primeiro pacote de Data, mesmo que já tenhamos feito algum Progress
(mas o Progress não tenha sido atualizado dentro do timeout `receive_data_timeout`); caso contrário, desabilitamos a troca de réplica depois da primeira vez em que houve Progress.
## allow\_create\_index\_without\_type
Permite a consulta CREATE INDEX sem TYPE. A consulta será ignorada. Destinado a testes de compatibilidade com SQL.
## allow\_custom\_error\_code\_in\_throwif
Habilita o uso de código de erro personalizado na função throwIf(). Se true, as exceções lançadas podem ter códigos de erro inesperados.
## allow\_ddl
Se estiver definido como true, o usuário poderá executar consultas DDL.
## allow\_distributed\_ddl
Se estiver definido como true, o usuário terá permissão para executar consultas de DDL distribuído.
## allow\_drop\_detached
Permite consultas `ALTER TABLE ... DROP DETACHED PART[ITION] ...`
## allow\_dynamic\_type\_in\_join\_keys
Permite usar o tipo Dynamic em chaves de JOIN. Adicionado por compatibilidade. Não é recomendável usar o tipo Dynamic em chaves de JOIN, porque a comparação com outros tipos pode levar a resultados inesperados.
## allow\_execute\_multiif\_columnar
Permite executar a função multiIf de forma colunar
## allow\_fuzz\_query\_functions
Habilita a função `fuzzQuery`, que aplica mutações aleatórias de AST a uma string de consulta.
## allow\_general\_join\_planning
Permite um algoritmo de planejamento de join mais abrangente, capaz de lidar com condições mais complexas, mas que funciona apenas com hash join. Se o hash join não estiver habilitado, o algoritmo de planejamento de join padrão será usado independentemente do valor desta configuração.
Permite usar a função `getClientHTTPHeader`, que permite obter o valor de um cabeçalho da requisição HTTP atual. Ela não é habilitada por padrão por motivos de segurança, pois alguns cabeçalhos, como `Cookie`, podem conter informações sensíveis. Observe que os cabeçalhos `X-ClickHouse-*`, `Authentication` e `Authorization` são sempre restritos e não podem ser obtidos com esta função.
## allow\_hyperscan
Permite funções que usam a biblioteca Hyperscan. Desative para evitar tempos de compilação potencialmente longos e uso excessivo de recursos.
## allow\_iceberg\_remove\_orphan\_files
Permite usar 'ALTER TABLE ... EXECUTE remove\_orphan\_files()' em tabelas Iceberg.
## allow\_insert\_into\_iceberg
**Aliases**: `allow_experimental_insert_into_iceberg`
Permite executar consultas `insert` no Iceberg.
## allow\_introspection\_functions
Habilita ou desabilita [funções de introspecção](/docs/pt-BR/reference/functions/regular-functions/introspection) para o perfilamento de consultas.
Valores possíveis:
* 1 — Funções de introspecção habilitadas.
* 0 — Funções de introspecção desabilitadas.
**Veja também**
* [Sampling Query Profiler](/docs/pt-BR/concepts/features/performance/troubleshoot/sampling-query-profiler)
* Tabela de sistema [trace\_log](/docs/pt-BR/reference/system-tables/trace_log)
## allow\_key\_condition\_coalesce\_rewrite
const` (e, de forma equivalente, `ifNull`, ou com a constante à esquerda) como uma disjunção antes da análise de índices, para que a chave primária por coluna e os índices de salto em cada `a_i` possam ser usados. Formas parcialmente constantes, como `coalesce(a, 42, b)` e `coalesce(a, b, 42)`, também são tratadas."}]}]} />
Permite que a chave primária e os índices de salto do MergeTree descartem grânulos para predicados `WHERE`/`PREWHERE` que envolvem `coalesce` ou `ifNull`. Sem essa configuração, esses predicados são opacos à análise de índices e não descartam grânulos, de modo que grânulos que não podem corresponder ainda são lidos. Isso afeta apenas quais grânulos são lidos; os resultados da consulta permanecem inalterados, porque as linhas ainda são filtradas pelo predicado original.
Duas formas de predicado são reescritas antes da análise de índices:
* Uma comparação com `coalesce`/`ifNull`, como `coalesce(a, b) = 5`, torna-se uma disjunção para que um índice em cada argumento possa descartar grânulos: `a = 5 OR (a IS NULL AND b = 5)`, com extensão para mais argumentos.
* Um `coalesce`/`ifNull` com uma constante padrão falsy (zero), usado diretamente como condição, como `ifNull(a = 5, 0)` ou `coalesce(a = 5, 0)`, é reduzido ao predicado interno `a = 5`. Esses encapsulamentos colapsam o resultado ternário do predicado interno em um booleano definido (mapeando `NULL` para `false`).
## allow\_limit\_by\_partitions\_independently
Habilita a avaliação independente de `LIMIT BY` em cada partição, em threads separadas, quando a expressão de partição é uma função determinística das colunas de `LIMIT BY`.
## allow\_materialized\_view\_with\_bad\_select
Permite CREATE MATERIALIZED VIEW com uma consulta SELECT que faz referência a tabelas ou colunas inexistentes. A consulta ainda precisa ser sintaticamente válida. Não se aplica a MVs atualizáveis. Não se aplica se o esquema da MV precisar ser inferido a partir da consulta SELECT (isto é, se o CREATE não tiver lista de colunas nem tabela de destino com TO). Pode ser usado para criar uma MV antes da tabela de origem.
## allow\_minmax\_index\_for\_json
Permite criar índices skip minmax em colunas JSON (Object). Desativado por padrão porque o
mecanismo de serialização do índice minmax não consegue lidar com os valores heterogêneos de Field que as colunas JSON podem conter.
## allow\_named\_collection\_override\_by\_default
Permite, por padrão, a substituição dos campos das coleções nomeadas.
## allow\_non\_metadata\_alters
Permite executar alters que afetam não apenas os metadados das tabelas, mas também os dados em disco
## allow\_nonconst\_timezone\_arguments
Permite argumentos de fuso horário não constantes em determinadas funções relacionadas a data e hora, como toTimeZone(), fromUnixTimestamp\*() e snowflakeIDToDateTime\*().
Essa configuração existe apenas por motivos de compatibilidade. No ClickHouse, o fuso horário é uma propriedade do tipo de dado e, por consequência, da coluna.
Ativar essa configuração passa a impressão errada de que valores diferentes dentro de uma coluna podem ter fusos horários diferentes.
Portanto, não ative essa configuração.
## allow\_nullable\_tuple\_in\_extracted\_subcolumns
Controla se subcolunas extraídas do tipo `Tuple(...)` podem ser tipadas como `Nullable(Tuple(...))`.
* `false`: Retorna `Tuple(...)` e usa os valores padrão da tupla para linhas em que a subcoluna está ausente.
* `true`: Retorna `Nullable(Tuple(...))` e usa `NULL` para linhas em que a subcoluna está ausente.
Esta configuração controla apenas o comportamento das subcolunas extraídas.
Ela não controla se colunas `Nullable(Tuple(...))` podem ser criadas em tabelas; isso é controlado por `enable_nullable_tuple_type`.
O ClickHouse usa o valor dessa configuração carregado na inicialização do servidor.
Alterações feitas com `SET` ou `SETTINGS` no nível da consulta não mudam o comportamento das subcolunas extraídas.
Para mudar o comportamento das subcolunas extraídas, atualize `allow_nullable_tuple_in_extracted_subcolumns` na configuração do perfil de inicialização (por exemplo, users.xml) e reinicie o servidor.
## allow\_rank\_dense\_rank\_arguments
Permite passar argumentos para as funções de janela `RANK` e `DENSE_RANK` por compatibilidade retroativa.
Segundo o padrão SQL, `RANK` e `DENSE_RANK` aceitam zero argumentos — elas classificam as linhas com base apenas na janela
`OVER (ORDER BY ...)`. Em versões do ClickHouse anteriores à 26.5, consultas como
`RANK(x) OVER (...)` aceitavam e ignoravam silenciosamente o argumento, o que gerava confusão entre os usuários
(o argumento visível sugeria que influenciava o ranking, mas não influenciava).
Quando essa configuração é `false` (o padrão), `RANK` e `DENSE_RANK` rejeitam quaisquer argumentos e
geram `NUMBER_OF_ARGUMENTS_DOESNT_MATCH`. Quando definida como `true`, o comportamento permissivo antigo é
restaurado — os argumentos são ignorados silenciosamente, como acontecia antes da versão 26.5.
## allow\_reorder\_prewhere\_conditions
Permite reordenar as condições ao movê-las de WHERE para PREWHERE, para otimizar a filtragem
## allow\_replace\_partition\_from\_empty\_source
Permite que `ALTER TABLE ... REPLACE PARTITION ... FROM ...` remova silenciosamente a partição de destino quando a origem não tiver partes nessa partição.
Por padrão, isso não é permitido: `REPLACE PARTITION` a partir de uma origem sem dados na partição solicitada gera uma exceção, porque, nesse caso, a operação efetivamente se torna um `DROP PARTITION` silencioso no destino (os dados do destino são removidos e nada os substitui), uma causa comum de perda acidental de dados (veja [#23727](https://github.com/ClickHouse/ClickHouse/issues/23727)).
Ative essa configuração para restaurar o comportamento anterior, por exemplo, quando você usa intencionalmente uma partição de origem vazia para limpar dados no destino. Para uma remoção incondicional, prefira `ALTER TABLE ... DROP PARTITION ...`.
## allow\_settings\_after\_format\_in\_insert
Controla se `SETTINGS` após `FORMAT` em consultas `INSERT` é permitido ou não. Não é recomendável usar isso, pois parte de `SETTINGS` pode ser interpretada como valores.
Exemplo:
```sql theme={null}
INSERT INTO FUNCTION null('foo String') SETTINGS max_threads=1 VALUES ('bar');
```
Mas a consulta a seguir só funcionará com `allow_settings_after_format_in_insert`:
```sql theme={null}
SET allow_settings_after_format_in_insert=1;
INSERT INTO FUNCTION null('foo String') VALUES ('bar') SETTINGS max_threads=1;
```
Valores possíveis:
* 0 — Não permitir.
* 1 — Permitir.
Use esta configuração apenas por compatibilidade retroativa, caso seus casos de uso dependam da sintaxe antiga.
## allow\_simdjson
Permite o uso da biblioteca simdjson em funções 'JSON\*' se as instruções AVX2 estiverem disponíveis. Se estiver desabilitado, a rapidjson será usada.
## allow\_special\_serialization\_kinds\_in\_output\_formats
Permite a saída de colunas com tipos especiais de serialização, como Sparse e Replicated, sem convertê-las para a representação completa da coluna.
Isso ajuda a evitar cópias de dados desnecessárias durante a formatação.
## allow\_unrestricted\_reads\_from\_keeper
Permite leituras irrestritas (sem condição no path) da tabela system.zookeeper; pode ser útil, mas não é seguro para o ZooKeeper