Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

configurações de sessão force_*

Essas configurações estão disponíveis em system.settings e são geradas automaticamente a partir do código-fonte.

force_aggregate_partitions_independently

Tipo
Bool
Padrão
0

Força o uso da otimização quando aplicável, mesmo que a heurística tenha decidido não usá-la

force_aggregation_in_order

Tipo
Bool
Padrão
0

Essa configuração é usada pelo próprio servidor para dar suporte a consultas distribuídas. Não a altere manualmente, pois isso prejudicará o funcionamento normal. (Força o uso de agregação em ordem em nós remotos durante a agregação distribuída).

force_creating_set_partitions_independently

Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
26.80Nova configuração para forçar a pré-desduplicação por partição na criação de conjuntos para `IN (subquery)`, mesmo quando a verificação de desequilíbrio entre partições a ignoraria.

Força a pré-desduplicação por partição na criação de conjuntos para IN (subquery) quando aplicável, mesmo que a verificação de desequilíbrio entre partições (a maior partição é mais de duas vezes maior que a média) tenha decidido não utilizá-la. Ignora apenas a verificação de desequilíbrio de allow_creating_set_partitions_independently; as demais condições ainda se aplicam.

force_data_skipping_indices

Desabilita a execução da consulta se os índices de salto de dados especificados não forem usados.

Considere o exemplo a seguir:

CREATE TABLE data
(
    key Int,
    d1 Int,
    d1_null Nullable(Int),
    INDEX d1_idx d1 TYPE minmax GRANULARITY 1,
    INDEX d1_null_idx assumeNotNull(d1_null) TYPE minmax GRANULARITY 1
)
Engine=MergeTree()
ORDER BY key;

SELECT * FROM data_01515;
SELECT * FROM data_01515 SETTINGS force_data_skipping_indices=''; -- query will produce CANNOT_PARSE_TEXT error.
SELECT * FROM data_01515 SETTINGS force_data_skipping_indices='d1_idx'; -- query will produce INDEX_NOT_USED error.
SELECT * FROM data_01515 WHERE d1 = 0 SETTINGS force_data_skipping_indices='d1_idx'; -- Ok.
SELECT * FROM data_01515 WHERE d1 = 0 SETTINGS force_data_skipping_indices='`d1_idx`'; -- Ok (example of full featured parser).
SELECT * FROM data_01515 WHERE d1 = 0 SETTINGS force_data_skipping_indices='`d1_idx`, d1_null_idx'; -- query will produce INDEX_NOT_USED error, since d1_null_idx is not used.
SELECT * FROM data_01515 WHERE d1 = 0 AND assumeNotNull(d1_null) = 0 SETTINGS force_data_skipping_indices='`d1_idx`, d1_null_idx'; -- Ok.

force_distinct_partitions_independently

Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
26.80Nova configuração para forçar a avaliação independente de `DISTINCT` por partição, mesmo quando a heurística de custo a ignoraria.

Força a avaliação independente de DISTINCT por partição quando aplicável, mas a heurística de custo decidiu não usá-la. Ignora apenas a heurística de custo de allow_distinct_partitions_independently; as demais condições continuam se aplicando.

force_grouping_standard_compatibility

Tipo
Bool
Padrão
1
Histórico de versões
VersãoValor padrãoComentário
22.91Faz com que a função GROUPING produza a mesma saída que no padrão SQL e em outros DBMS

Faz com que a função GROUPING retorne 1 quando o argumento não é usado como chave de agregação

force_index_by_date

Tipo
Bool
Padrão
0

Desativa a execução da consulta se o índice não puder ser usado com base na data.

Funciona com tabelas da família MergeTree.

Se force_index_by_date=1, o ClickHouse verifica se a consulta tem uma condição na chave de data que possa ser usada para restringir intervalos de dados. Se não houver uma condição adequada, ele lança uma exceção. No entanto, não verifica se a condição reduz a quantidade de dados a serem lidos. Por exemplo, a condição Date != ' 2000-01-01 ' é aceitável mesmo quando corresponde a todos os dados da tabela (ou seja, executar a consulta exige um full scan). Para mais informações sobre intervalos de dados em tabelas MergeTree, consulte MergeTree.

force_primary_key

Tipo
Bool
Padrão
0

Desativa a execução da consulta se não for possível usar indexação pela chave primária.

Funciona com tabelas da família MergeTree.

Se force_primary_key=1, o ClickHouse verifica se a consulta tem uma condição de chave primária que possa ser usada para restringir os intervalos de dados. Se não houver uma condição adequada, ele lançará uma exceção. No entanto, ele não verifica se a condição reduz a quantidade de dados a serem lidos. Para mais informações sobre intervalos de dados em tabelas MergeTree, consulte MergeTree.

force_read_through_distributed_cache

Somente no ClickHouse Cloud
Tipo
BoolAuto
Padrão
auto
Histórico de versões
VersãoValor padrãoComentário
26.9autoNova configuração que substitui a configuração do servidor `enable_read_through_distributed_cache` em uma única consulta.
26.8autoNova configuração que substitui a configuração do servidor `enable_read_through_distributed_cache` em uma única consulta.

Só tem efeito no ClickHouse Cloud. Substitui a configuração do servidor enable_read_through_distributed_cache em uma única consulta. auto (o padrão) significa usar a configuração do servidor.

force_remove_data_recursively_on_drop

Tipo
Bool
Padrão
0

Remove os dados recursivamente ao executar a consulta DROP. Evita o erro 'Directory not empty', mas pode remover silenciosamente dados desanexados

force_window_partitions_independently

Tipo
Bool
Padrão
0
Histórico de versões
VersãoValor padrãoComentário
26.80Nova configuração para forçar a avaliação independente de funções de janela por partição, mesmo quando a heurística de custo a ignoraria.

Força a avaliação independente de funções de janela por partição quando ela for aplicável, mas a heurística de custo tiver decidido não utilizá-la. Ignora apenas a heurística de custo de allow_window_partitions_independently; as demais condições continuam sendo aplicadas.

force_write_through_distributed_cache

Somente no ClickHouse Cloud
Tipo
BoolAuto
Padrão
auto
Histórico de versões
VersãoValor padrãoComentário
26.9autoNova configuração que substitui a configuração do servidor `enable_write_through_distributed_cache` em uma única consulta.
26.8autoNova configuração que substitui a configuração do servidor `enable_write_through_distributed_cache` em uma única consulta.

Tem efeito somente no ClickHouse Cloud. Substitui a configuração do servidor enable_write_through_distributed_cache em uma única consulta. auto (o padrão) indica que a configuração do servidor deve ser seguida.

Navigation