paramètres de session alter_*

Les paramètres de session ClickHouse du groupe généré alter_*.

Ces paramètres sont disponibles dans system.settings et sont générés automatiquement à partir du code source.

​

alter_move_to_space_execute_async

Exécute ALTER TABLE MOVE … TO [DISK|VOLUME] de manière asynchrone

​

alter_partition_verbose_result

Active ou désactive l’affichage d’informations sur les parts auxquelles les opérations sur les partitions et les parts ont été appliquées avec succès. S’applique à ATTACH PARTITION|PART et à FREEZE PARTITION.

Valeurs possibles :

• 0 — désactiver le mode verbose.
• 1 — activer le mode verbose.

Exemple

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

Alias : replication_alter_partitions_sync

Permet de spécifier le comportement d’attente pour les actions à exécuter sur les répliques par les requêtes ALTER, OPTIMIZE ou TRUNCATE.

Valeurs possibles :

• 0 — Ne pas attendre.
• 1 — Attendre l’exécution locale.
• 2 — Attendre toutes les répliques.
• 3 - Attendre uniquement les répliques actives. Les répliques inactives appliquent la modification lorsqu’elles redeviennent actives.

Valeur par défaut dans Cloud : 0.

alter_sync s’applique uniquement aux tables Replicated et SharedMergeTree ; il n’a aucun effet sur les tables non Replicated ou Shared.

​

alter_update_mode

Mode des requêtes ALTER qui contiennent des commandes UPDATE.

Valeurs possibles :

• heavy - exécute une mutation classique.
• lightweight - exécute une mise à jour légère si possible, sinon une mutation classique.
• lightweight_force - exécute une mise à jour légère si possible, sinon lève une exception.