> ## 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.

# asynchronous_* 서버 설정

> asynchronous_*로 생성된 그룹의 ClickHouse 서버 설정입니다.

이 설정은 ClickHouse 서버를 구성하며, ClickHouse 소스에서 자동으로 생성됩니다.

## asynchronous\_heavy\_metrics\_update\_period\_s

유형 UInt32 기본값 120 재시작 없이 변경 가능 No고비용 비동기 메트릭의 업데이트 주기(초)입니다.

## asynchronous\_insert\_log

비동기 삽입을 로깅하는 [asynchronous\_insert\_log](https://clickhouse.com/docs/ko/reference/system-tables/asynchronous_insert_log.md) 시스템 테이블에 대한 설정입니다.

다음 설정은 하위 태그로 구성할 수 있습니다:

| 설정 | 설명 | 기본값 | 참고 |
| - | - | - | - |
| `database` | 데이터베이스 이름입니다. | | |
| `table` | 시스템 테이블 이름입니다. | | |
| `engine` | 시스템 테이블용 [MergeTree 엔진 정의](https://clickhouse.com/docs/ko/reference/engines/table-engines/mergetree-family/mergetree.md#table_engine-mergetree-creating-a-table)입니다. | | `partition_by` 또는 `order_by`가 정의된 경우에는 사용할 수 없습니다. 지정하지 않으면 기본적으로 `MergeTree`가 선택됩니다. |
| `partition_by` | 시스템 테이블용 [사용자 지정 파티셔닝 키](https://clickhouse.com/docs/ko/reference/engines/table-engines/mergetree-family/custom-partitioning-key.md)입니다. | | 시스템 테이블에 `engine`이 지정된 경우 `partition_by` 매개변수는 'engine' 내부에 직접 지정해야 합니다. |
| `ttl` | 테이블 [TTL](https://clickhouse.com/docs/ko/reference/engines/table-engines/mergetree-family/mergetree.md#table_engine-mergetree-ttl)을 지정합니다. | | 시스템 테이블에 `engine`이 지정된 경우 `ttl` 매개변수는 'engine' 내부에 직접 지정해야 합니다. |
| `order_by` | 시스템 테이블용 [사용자 지정 정렬 키](https://clickhouse.com/docs/ko/reference/engines/table-engines/mergetree-family/mergetree.md#order_by)입니다. `engine`이 정의된 경우 사용할 수 없습니다. | | 시스템 테이블에 `engine`이 지정된 경우 `order_by` 매개변수는 'engine' 내부에 직접 지정해야 합니다. |
| `storage_policy` | 테이블에 사용할 스토리지 정책 이름입니다(선택 사항). | | 시스템 테이블에 `engine`이 지정된 경우 `storage_policy` 매개변수는 'engine' 내부에 직접 지정해야 합니다. |
| `settings` | MergeTree 동작을 제어하는 [추가 매개변수](https://clickhouse.com/docs/ko/reference/engines/table-engines/mergetree-family/mergetree.md#settings)입니다(선택 사항). | | 시스템 테이블에 `engine`이 지정된 경우 `settings` 매개변수는 'engine' 내부에 직접 지정해야 합니다. |
| `flush_interval_milliseconds` | 메모리 버퍼의 데이터를 테이블로 플러시하는 주기입니다. | `7500` | |
| `max_size_rows` | 로그의 최대 행 수입니다. 플러시되지 않은 로그 수가 max\_size에 도달하면 로그가 디스크에 덤프됩니다. | `1048576` | |
| `reserved_size_rows` | 로그를 위해 미리 할당하는 메모리 크기(행 수 기준)입니다. | `8192` | |
| `buffer_size_rows_flush_threshold` | 행 수 기준 임계값입니다. 이 임계값에 도달하면 로그를 디스크에 플러시하는 작업이 백그라운드에서 시작됩니다. | `max_size_rows / 2` | |
| `flush_on_crash` | 충돌 발생 시 로그를 디스크에 덤프할지 여부를 설정합니다. | `false` | |

`database`, `table`, `engine`을 제외한 모든 설정은 `system_tables` 섹션에서 모든 시스템 로그 테이블에 일괄 적용되도록 한 번에 지정할 수도 있습니다. 개별 테이블 섹션에 지정한 설정이 우선 적용되며, 테이블별로 지정한 `engine`은 전역 `partition_by`, `ttl`, `order_by`, `storage_policy`, `settings`를 포함한 엔진 정의 전체를 대체합니다:

```xml theme={null}
<system_tables>
    <ttl>event_date + INTERVAL 30 DAY DELETE</ttl>
</system_tables>
```

`system_tables` 섹션에서는 다음 설정도 추가로 사용할 수 있습니다. 이 설정은 모든 시스템 로그 테이블에 적용되며 테이블별로 지정할 수 없습니다:

| 설정 | 설명 | 기본값 |
| - | - | - |
| `skip_alias_columns` | `true`로 설정하면 시스템 로그 테이블 스키마에서 ALIAS 컬럼이 제외됩니다. S3 기반 시스템 로그에 필요합니다. | `false` |

이 설정의 이전 위치인 `default_system_log_flush_policy.skip_alias_columns`는 사용 중단 권고 상태이며, `system_tables.skip_alias_columns`가 설정되지 않은 경우에만 사용됩니다.

**예시**

```xml theme={null}
<clickhouse>
    <asynchronous_insert_log>
        <database>system</database>
        <table>asynchronous_insert_log</table>
        <flush_interval_milliseconds>7500</flush_interval_milliseconds>
        <partition_by>toYYYYMM(event_date)</partition_by>
        <max_size_rows>1048576</max_size_rows>
        <reserved_size_rows>8192</reserved_size_rows>
        <buffer_size_rows_flush_threshold>524288</buffer_size_rows_flush_threshold>
        <flush_on_crash>false</flush_on_crash>
        <!-- <engine>Engine = MergeTree PARTITION BY event_date ORDER BY event_time TTL event_date + INTERVAL 30 day</engine> -->
    </asynchronous_insert_log>
</clickhouse>
```

## asynchronous\_metric\_log

ClickHouse Cloud 배포에서는 기본적으로 활성화됩니다.

사용 중인 환경에서 이 설정이 기본적으로 활성화되어 있지 않다면, ClickHouse 설치 방식에 따라 아래 지침에 따라 활성화하거나 비활성화할 수 있습니다.

**활성화**

`system.asynchronous_metric_log`의 비동기 메트릭 로그 이력 수집을 수동으로 활성화하려면 [시스템 테이블 참고](https://clickhouse.com/docs/ko/reference/system-tables/asynchronous_metric_log.md)를 확인하고, 다음 내용으로 `/etc/clickhouse-server/config.d/asynchronous_metric_log.xml` 파일을 생성하십시오:

```xml theme={null}
<clickhouse>
     <asynchronous_metric_log>
        <database>system</database>
        <table>asynchronous_metric_log</table>
        <flush_interval_milliseconds>7500</flush_interval_milliseconds>
        <collect_interval_milliseconds>1000</collect_interval_milliseconds>
        <max_size_rows>1048576</max_size_rows>
        <reserved_size_rows>8192</reserved_size_rows>
        <buffer_size_rows_flush_threshold>524288</buffer_size_rows_flush_threshold>
        <flush_on_crash>false</flush_on_crash>
    </asynchronous_metric_log>
</clickhouse>
```

**비활성화**

`asynchronous_metric_log` 설정을 비활성화하려면 다음 내용으로 `/etc/clickhouse-server/config.d/disable_asynchronous_metric_log.xml` 파일을 생성하십시오:

```xml theme={null}
<clickhouse><asynchronous_metric_log remove="1" /></clickhouse>
```

다음 설정은 하위 태그로 구성할 수 있습니다:

| 설정 | 설명 | 기본값 | 참고 |
| - | - | - | - |
| `database` | 데이터베이스 이름입니다. | | |
| `table` | 시스템 테이블 이름입니다. | | |
| `engine` | 시스템 테이블용 [MergeTree 엔진 정의](https://clickhouse.com/docs/ko/reference/engines/table-engines/mergetree-family/mergetree.md#table_engine-mergetree-creating-a-table)입니다. | | `partition_by` 또는 `order_by`가 정의된 경우에는 사용할 수 없습니다. 지정하지 않으면 기본적으로 `MergeTree`가 선택됩니다. |
| `partition_by` | 시스템 테이블용 [사용자 지정 파티셔닝 키](https://clickhouse.com/docs/ko/reference/engines/table-engines/mergetree-family/custom-partitioning-key.md)입니다. | | 시스템 테이블에 `engine`이 지정된 경우 `partition_by` 매개변수는 'engine' 내부에 직접 지정해야 합니다. |
| `ttl` | 테이블 [TTL](https://clickhouse.com/docs/ko/reference/engines/table-engines/mergetree-family/mergetree.md#table_engine-mergetree-ttl)을 지정합니다. | | 시스템 테이블에 `engine`이 지정된 경우 `ttl` 매개변수는 'engine' 내부에 직접 지정해야 합니다. |
| `order_by` | 시스템 테이블용 [사용자 지정 정렬 키](https://clickhouse.com/docs/ko/reference/engines/table-engines/mergetree-family/mergetree.md#order_by)입니다. `engine`이 정의된 경우 사용할 수 없습니다. | | 시스템 테이블에 `engine`이 지정된 경우 `order_by` 매개변수는 'engine' 내부에 직접 지정해야 합니다. |
| `storage_policy` | 테이블에 사용할 스토리지 정책 이름입니다(선택 사항). | | 시스템 테이블에 `engine`이 지정된 경우 `storage_policy` 매개변수는 'engine' 내부에 직접 지정해야 합니다. |
| `settings` | MergeTree 동작을 제어하는 [추가 매개변수](https://clickhouse.com/docs/ko/reference/engines/table-engines/mergetree-family/mergetree.md#settings)입니다(선택 사항). | | 시스템 테이블에 `engine`이 지정된 경우 `settings` 매개변수는 'engine' 내부에 직접 지정해야 합니다. |
| `flush_interval_milliseconds` | 메모리 버퍼의 데이터를 테이블로 플러시하는 주기입니다. | `7500` | |
| `max_size_rows` | 로그의 최대 행 수입니다. 플러시되지 않은 로그 수가 max\_size에 도달하면 로그가 디스크에 덤프됩니다. | `1048576` | |
| `reserved_size_rows` | 로그를 위해 미리 할당하는 메모리 크기(행 수 기준)입니다. | `8192` | |
| `buffer_size_rows_flush_threshold` | 행 수 기준 임계값입니다. 이 임계값에 도달하면 로그를 디스크에 플러시하는 작업이 백그라운드에서 시작됩니다. | `max_size_rows / 2` | |
| `flush_on_crash` | 충돌 발생 시 로그를 디스크에 덤프할지 여부를 설정합니다. | `false` | |

`database`, `table`, `engine`을 제외한 모든 설정은 `system_tables` 섹션에서 모든 시스템 로그 테이블에 일괄 적용되도록 한 번에 지정할 수도 있습니다. 개별 테이블 섹션에 지정한 설정이 우선 적용되며, 테이블별로 지정한 `engine`은 전역 `partition_by`, `ttl`, `order_by`, `storage_policy`, `settings`를 포함한 엔진 정의 전체를 대체합니다:

```xml theme={null}
<system_tables>
    <ttl>event_date + INTERVAL 30 DAY DELETE</ttl>
</system_tables>
```

`system_tables` 섹션에서는 다음 설정도 추가로 사용할 수 있습니다. 이 설정은 모든 시스템 로그 테이블에 적용되며 테이블별로 지정할 수 없습니다:

| 설정 | 설명 | 기본값 |
| - | - | - |
| `skip_alias_columns` | `true`로 설정하면 시스템 로그 테이블 스키마에서 ALIAS 컬럼이 제외됩니다. S3 기반 시스템 로그에 필요합니다. | `false` |

이 설정의 이전 위치인 `default_system_log_flush_policy.skip_alias_columns`는 사용 중단 권고 상태이며, `system_tables.skip_alias_columns`가 설정되지 않은 경우에만 사용됩니다.
