` 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\_delta\_kernel\_rs
**Aliases**: `allow_experimental_delta_kernel_rs`
Permite usar a implementação `delta-kernel-rs` para ler tabelas Delta Lake.
## allow\_distinct\_partitions\_independently
Habilita a avaliação independente de `DISTINCT` por partição em threads separadas quando a expressão de partição é uma função determinística das colunas de `DISTINCT`, dispensando a mesclagem entre fluxos. É vantajoso quando o número de partições é próximo ao número de núcleos e as partições têm aproximadamente o mesmo tamanho; caso contrário, uma heurística de custo a desativa. Consulte [max\_number\_of\_partitions\_for\_independent\_distinct](/pt-BR/reference/settings/session-settings/max-number#max_number_of_partitions_for_independent_distinct) e [force\_distinct\_partitions\_independently](/pt-BR/reference/settings/session-settings/force#force_distinct_partitions_independently). Não se aplica com `FINAL` nem com réplicas paralelas.
Não se aplica quando [max\_rows\_in\_distinct](/pt-BR/reference/settings/session-settings/max-rows#max_rows_in_distinct) ou [max\_bytes\_in\_distinct](/pt-BR/reference/settings/session-settings/max-bytes#max_bytes_in_distinct) está definido: esses limites são aplicados pela única transformada `DISTINCT` que processa todo o resultado mesclado; por isso, a mesclagem entre fluxos é mantida para preservar seu significado global.
## 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](/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](/pt-BR/concepts/features/performance/troubleshoot/sampling-query-profiler)
* Tabela de sistema [trace\_log](/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."}]}]} />
Reescreve predicados da forma `coalesce(a_1, ..., a_N) const` (e, de forma equivalente, `ifNull`, ou com a constante à esquerda) como a disjunção `(a_1 const) OR (a_1 IS NULL AND a_2 const) OR ... OR (a_1 IS NULL AND ... AND a_{N-1} IS NULL AND a_N const)` 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)`, são tratadas: a lista de argumentos é normalizada da mesma forma que o próprio `coalesce` (literais `NULL` são removidos, assim como os argumentos após o primeiro que não seja `Nullable`), e uma constante não `NULL` ao final, se houver, é emitida como o ramo final. A reescrita é estritamente aditiva para o descarte por índices; a filtragem em tempo de execução continua usando o predicado original.
Além disso, predicados de igualdade exata da forma `nullIf(key, sentinel) = const` (em que `sentinel != const` e os tipos correspondem exatamente) são reescritos para `key = const`, para que a chave primária, a partição e os índices de salto em `key` possam descartar grânulos diretamente. Não há suporte para eliminação de `nullIf` por intervalo ou disjunção.
## 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\_lossy\_numeric\_supertype
Quando ativada, `if`/`multiIf`/`coalesce`/`ifNull`/`array`/`map` aplicados a um conjunto de argumentos numéricos que não tem um tipo comum sem perda (por exemplo, um `Decimal` e um `Float64`, ou um `Int64` e um `Float64`) são resolvidos para um supertipo numérico (`Float64`) em vez de falharem, com possível perda de precisão. Isso permite usar o resultado diretamente com funções de agregação que combinam valores, como `sum`, `avg`, `min` e `max`. Essa opção é independente de `use_variant_as_common_type`: o supertipo numérico é produzido independentemente de `use_variant_as_common_type` estar ativada ou não. Quando desativada (o padrão), esses conjuntos de argumentos não têm um tipo comum e, portanto, tornam-se um `Variant` (se `use_variant_as_common_type` estiver ativada) ou geram `NO_COMMON_TYPE`.
## 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