> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# alter_* セッション設定

> alter_* 生成グループ内の ClickHouse のセッション設定。

これらの設定は [system.settings](https://clickhouse.com/docs/ja/reference/system-tables/settings.md) で確認でき、[source](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp) から自動生成されています。

## alter\_move\_to\_space\_execute\_async

型

Bool

デフォルト値

0

ALTER TABLE MOVE ... TO \[DISK|VOLUME] を非同期で実行します

## alter\_partition\_verbose\_result

型

Bool

デフォルト値

0

パーティションおよびパーツに対する操作が正常に適用されたパーツに関する情報を表示するかどうかを設定します。
[ATTACH PARTITION|PART](https://clickhouse.com/docs/ja/reference/statements/alter/partition.md#attach-partitionpart) および [FREEZE PARTITION](https://clickhouse.com/docs/ja/reference/statements/alter/partition.md#freeze-partition) に適用されます。

設定可能な値:

* 0 — 詳細表示を無効にします。
* 1 — 詳細表示を有効にします。

**例**

```sql theme={null}
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`](https://clickhouse.com/docs/ja/reference/statements/alter/index)、[`OPTIMIZE`](https://clickhouse.com/docs/ja/reference/statements/optimize)、[`TRUNCATE`](https://clickhouse.com/docs/ja/reference/statements/truncate) クエリが、その操作の完了をどのように待機するかを指定できます。

設定可能な値:

* `0` — 待機しません。
* `1` — 自身での実行完了を待機します。
* `2` — すべてのレプリカでの実行完了を待機します。
* `3` - アクティブなレプリカでの実行完了のみを待機します。非アクティブなレプリカは、アクティブになった時点で変更を適用します。

Cloud でのデフォルト値: `0`.

> [!NOTE]
>
> `alter_sync` は `MergeTree` ファミリーのテーブルに対する `ALTER` クエリに適用されます。値 `2` および `3` でレプリカの完了を待機するのは、`ReplicatedMergeTree` テーブルおよび `SharedMergeTree` テーブルの場合のみです。

## alter\_update\_mode

型

AlterUpdateMode

デフォルト値

heavy

`UPDATE` コマンドを含む `ALTER` クエリに使用するモードです。

設定可能な値:

* `heavy` - 通常の mutation を実行します。
* `lightweight` - 可能であれば論理更新を実行し、そうでない場合は通常の mutation を実行します。
* `lightweight_force` - 可能であれば論理更新を実行し、そうでない場合は例外を発生させます。
