Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

alter_* session settings

These settings are available in system.settings and are autogenerated from source.

alter_move_to_space_execute_async

Type
Bool
Default
0

Execute ALTER TABLE MOVE … TO [DISK|VOLUME] asynchronously

alter_partition_verbose_result

Type
Bool
Default
0

Enables or disables the display of information about the parts to which the manipulation operations with partitions and parts have been successfully applied. Applicable to ATTACH PARTITION|PART and to FREEZE PARTITION.

Possible values:

  • 0 — disable verbosity.
  • 1 — enable verbosity.

Example

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;

alter_sync

Aliases: replication_alter_partitions_sync

Type
UInt64
Default
1

Allows you to specify the wait behavior for actions that are to be executed on replicas by ALTER, OPTIMIZE or TRUNCATE queries.

Possible values:

  • 0 — Do not wait.
  • 1 — Wait for own execution.
  • 2 — Wait for everyone.
  • 3 - Only wait for active replicas.

Cloud default value: 0.

alter_update_mode

Type
AlterUpdateMode
Default
heavy
Version history
VersionDefault valueComment
25.5heavyA new setting

A mode for ALTER queries that have the UPDATE commands.

Possible values:

  • heavy - run regular mutation.
  • lightweight - run lightweight update if possible, run regular mutation otherwise.
  • lightweight_force - run lightweight update if possible, throw otherwise.
Navigation