настройки сеанса alter_*

Настройки сеанса ClickHouse в автоматически созданной группе alter_*.

Эти настройки доступны в system.settings и автоматически генерируются на основе исходного кода.

​

alter_move_to_space_execute_async

Выполнять ALTER TABLE MOVE … TO [DISK|VOLUME] асинхронно

​

alter_partition_verbose_result

Включает или отключает отображение информации о частях, к которым были успешно применены операции с партициями и частями. Применяется к ATTACH PARTITION|PART и FREEZE PARTITION.

Возможные значения:

• 0 — отключить подробный вывод.
• 1 — включить подробный вывод.

Пример

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

Псевдонимы: replication_alter_partitions_sync

Позволяет задать, как запросы ALTER, OPTIMIZE или TRUNCATE ожидают завершения своих операций.

Возможные значения:

• 0 — Не ждать.
• 1 — Ждать выполнения на текущей реплике.
• 2 — Ждать выполнения на всех репликах.
• 3 - Ждать только активные реплики. Неактивные реплики применят изменение, когда станут активными.

Значение по умолчанию в Cloud: 0.

alter_sync применяется к запросам ALTER для таблиц семейства MergeTree. Значения 2 и 3 ожидают реплики только для таблиц ReplicatedMergeTree и SharedMergeTree.

​

alter_update_mode

Режим для запросов ALTER, содержащих команду UPDATE.

Возможные значения:

• heavy - выполнить обычную мутацию.
• lightweight - выполнить легковесное обновление, если это возможно; в противном случае выполнить обычную мутацию.
• lightweight_force - выполнить легковесное обновление, если это возможно; в противном случае сгенерировать исключение.