configurações de sessão alter_*

Configurações de sessão do ClickHouse no grupo gerado alter_*.

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

​

alter_move_to_space_execute_async

Executa ALTER TABLE MOVE … TO [DISK|VOLUME] de forma assíncrona

​

alter_partition_verbose_result

Ativa ou desativa a exibição de informações sobre as partes às quais as operações de manipulação de partições e partes foram aplicadas com sucesso. Aplicável a ATTACH PARTITION|PART e a FREEZE PARTITION.

Valores possíveis:

• 0 — desativa a verbosidade.
• 1 — ativa a verbosidade.

Exemplo

CREATE TABLE test(a Int64, d Date, s String) ENGINE = MergeTree PARTITION BY toYYYYMDECLARE(d) ORDER BY a;
INSERT INTO test VALUES(1, '2021-01-01', '');
INSERT INTO test VALUES(1, '2021-01-01', '');
ALTER TABLE test DETACH PARTITION ID '202101';

ALTER TABLE test ATTACH PARTITION ID '202101' SETTINGS alter_partition_verbose_result = 1;

┌─command_type─────┬─partition_id─┬─part_name────┬─old_part_name─┐
│ ATTACH PARTITION │ 202101       │ 202101_7_7_0 │ 202101_5_5_0  │
│ ATTACH PARTITION │ 202101       │ 202101_8_8_0 │ 202101_6_6_0  │
└──────────────────┴──────────────┴──────────────┴───────────────┘

ALTER TABLE test FREEZE SETTINGS alter_partition_verbose_result = 1;

┌─command_type─┬─partition_id─┬─part_name────┬─backup_name─┬─backup_path───────────────────┬─part_backup_path────────────────────────────────────────────┐
│ FREEZE ALL   │ 202101       │ 202101_7_7_0 │ 8           │ /var/lib/clickhouse/shadow/8/ │ /var/lib/clickhouse/shadow/8/data/default/test/202101_7_7_0 │
│ FREEZE ALL   │ 202101       │ 202101_8_8_0 │ 8           │ /var/lib/clickhouse/shadow/8/ │ /var/lib/clickhouse/shadow/8/data/default/test/202101_8_8_0 │
└──────────────┴──────────────┴──────────────┴─────────────┴───────────────────────────────┴─────────────────────────────────────────────────────────────┘

​

alter_sync

Aliases: replication_alter_partitions_sync

Permite especificar o comportamento de espera para ações que devem ser executadas em réplicas por consultas ALTER, OPTIMIZE ou TRUNCATE.

Valores possíveis:

• 0 — Não aguardar.
• 1 — Aguardar a própria execução.
• 2 — Aguardar todas.
• 3 - Aguardar apenas as réplicas ativas. As réplicas inativas aplicam a alteração quando se tornam ativas.

Valor padrão no Cloud: 0.

alter_sync se aplica apenas a tabelas Replicated e SharedMergeTree; não tem efeito ao alterar tabelas que não sejam Replicated ou Shared.

​

alter_update_mode

Modo para consultas ALTER com comandos UPDATE.

Valores possíveis:

• heavy - executa a mutação regular.
• lightweight - executa atualização leve, se possível; caso contrário, executa a mutação regular.
• lightweight_force - executa atualização leve, se possível; caso contrário, lança uma exceção.