Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

alter_* 会话设置

View as MarkdownEdit this pageReport an issueSet up docs MCP

这些设置可在 system.settings 中查看，并由 源代码 自动生成。

alter_move_to_space_execute_async

类型
Bool
默认值
0

以异步方式执行 ALTER TABLE MOVE … TO [DISK|VOLUME]

alter_partition_verbose_result

类型
Bool
默认值
0

启用或禁用显示已成功应用于分区和 parts 的操作所涉及的 parts 信息。 适用于 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

类型
UInt64
默认值
1

用于指定由 ALTER、OPTIMIZE 或 TRUNCATE 查询触发、并在副本上执行的操作的等待行为。

可能的值：

  • 0 — 不等待。
  • 1 — 等待本副本执行完成。
  • 2 — 等待所有副本完成。
  • 3 - 仅等待活跃副本。

Cloud 默认值：0。

alter_update_mode

类型
AlterUpdateMode
默认值
heavy
版本历史
版本默认值注释
25.5heavy新增设置

用于带有 UPDATE 命令的 ALTER 查询的模式。

可能的值：

  • heavy - 执行常规变更。
  • lightweight - 如果可以，则执行轻量级更新；否则执行常规变更。
  • lightweight_force - 如果可以，则执行轻量级更新；否则抛出异常。
Navigation