> ## 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 세션 설정입니다.

export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
  return <div className="not-prose" style={{
    display: "flex",
    flexWrap: "wrap",
    alignItems: "baseline",
    columnGap: "0.5rem",
    rowGap: "0.125rem",
    margin: "0.375rem 0",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <div style={{
    fontWeight: 600,
    opacity: 0.72
  }}>유형</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>기본값</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          재시작 없이 변경 가능
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

이러한 설정은 [system.settings](/docs/ko/reference/system-tables/settings)에서 확인할 수 있으며, [source](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp)로부터 자동 생성됩니다.

<div id="alter_move_to_space_execute_async">
  ## alter\_move\_to\_space\_execute\_async
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

ALTER TABLE MOVE ... TO \[DISK|VOLUME]를 비동기적으로 실행합니다

<div id="alter_partition_verbose_result">
  ## alter\_partition\_verbose\_result
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

파티션 및 파트에 대한 조작 작업이 성공적으로 적용된 파트 정보를 표시할지 여부를 설정합니다.
[ATTACH PARTITION|PART](/docs/ko/reference/statements/alter/partition#attach-partitionpart) 및 [FREEZE PARTITION](/docs/ko/reference/statements/alter/partition#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 │
└──────────────┴──────────────┴──────────────┴─────────────┴───────────────────────────────┴─────────────────────────────────────────────────────────────┘
```

<div id="alter_sync">
  ## alter\_sync
</div>

**별칭**: `replication_alter_partitions_sync`

<SettingsInfoBlock type="UInt64" default_value="1" />

[`ALTER`](/docs/ko/reference/statements/alter/index), [`OPTIMIZE`](/docs/ko/reference/statements/optimize) 또는 [`TRUNCATE`](/docs/ko/reference/statements/truncate) 쿼리에서 레플리카에서 실행되는 작업에 대해 어떻게 대기할지 지정할 수 있습니다.

가능한 값:

* `0` — 대기하지 않습니다.
* `1` — 자체 실행이 완료될 때까지 대기합니다.
* `2` — 모두 완료될 때까지 대기합니다.
* `3` - 활성 레플리카에 대해서만 대기합니다.

Cloud 기본값: `0`.

<Note>
  `alter_sync`는 `Replicated` 및 `SharedMergeTree` 테이블에만 적용되며, `Replicated` 또는 `Shared`가 아닌 테이블을 변경할 때는 아무런 영향을 주지 않습니다.
</Note>

<div id="alter_update_mode">
  ## alter\_update\_mode
</div>

<SettingsInfoBlock type="AlterUpdateMode" default_value="heavy" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "heavy"},{"label": "새로운 설정"}]}]} />

`UPDATE` 명령이 포함된 `ALTER` 쿼리의 모드입니다.

가능한 값:

* `heavy` - 일반 mutation을 수행합니다.
* `lightweight` - 가능하면 경량 업데이트를 수행하고, 그렇지 않으면 일반 mutation을 수행합니다.
* `lightweight_force` - 가능하면 경량 업데이트를 수행하고, 그렇지 않으면 예외를 발생시킵니다.