asynchronous_* 服务器设置

这些设置用于配置 ClickHouse 服务器，由 ClickHouse 源代码自动生成。

asynchronous_heavy_metrics_update_period_s

用于更新高开销异步指标的周期 (以秒为单位) 。

asynchronous_insert_log

用于记录异步插入日志的 asynchronous_insert_log 系统表设置。以下设置可通过子标签配置：

Setting	Description	Default	Note
`database`	数据库名称。
`table`	系统表名称。
`engine`	系统表的 MergeTree 引擎定义。		如果已定义 `partition_by` 或 `order_by`，则不能使用。如果未指定，默认使用 `MergeTree`
`partition_by`	系统表的自定义分区键。		如果为系统表指定了 `engine`，则应直接在 ‘engine’ 内指定 `partition_by` 参数
`ttl`	指定表的生存时间 (TTL)。		如果为系统表指定了 `engine`，则应直接在 ‘engine’ 内指定 `ttl` 参数
`order_by`	系统表的自定义排序键。如果定义了 `engine`，则不能使用。		如果为系统表指定了 `engine`，则应直接在 ‘engine’ 内指定 `order_by` 参数
`storage_policy`	该表使用的存储策略名称 (可选) 。		如果为系统表指定了 `engine`，则应直接在 ‘engine’ 内指定 `storage_policy` 参数
`settings`	控制 MergeTree 行为的附加参数 (可选) 。		如果为系统表指定了 `engine`，则应直接在 ‘engine’ 内指定 `settings` 参数
`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`

此外，以下服务器级设置控制所有系统日志表的默认刷写策略：

<default_system_log_flush_policy>
    <skip_alias_columns>true</skip_alias_columns>
</default_system_log_flush_policy>

设置	描述	默认值
`skip_alias_columns`	为 `true` 时，系统日志表的 schema 中会省略 ALIAS 列。S3 支持的系统日志需要启用此项。	`false`

示例

<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 的异步指标日志历史记录收集，请参阅系统表参考，并创建 /etc/clickhouse-server/config.d/asynchronous_metric_log.xml，内容如下：

<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，内容如下：

<clickhouse><asynchronous_metric_log remove="1" /></clickhouse>

以下设置可通过子标签配置：

Setting	Description	Default	Note
`database`	数据库名称。
`table`	系统表名称。
`engine`	系统表的 MergeTree 引擎定义。		如果已定义 `partition_by` 或 `order_by`，则不能使用。如果未指定，默认使用 `MergeTree`
`partition_by`	系统表的自定义分区键。		如果为系统表指定了 `engine`，则应直接在 ‘engine’ 内指定 `partition_by` 参数
`ttl`	指定表的生存时间 (TTL)。		如果为系统表指定了 `engine`，则应直接在 ‘engine’ 内指定 `ttl` 参数
`order_by`	系统表的自定义排序键。如果定义了 `engine`，则不能使用。		如果为系统表指定了 `engine`，则应直接在 ‘engine’ 内指定 `order_by` 参数
`storage_policy`	该表使用的存储策略名称 (可选) 。		如果为系统表指定了 `engine`，则应直接在 ‘engine’ 内指定 `storage_policy` 参数
`settings`	控制 MergeTree 行为的附加参数 (可选) 。		如果为系统表指定了 `engine`，则应直接在 ‘engine’ 内指定 `settings` 参数
`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`

此外，以下服务器级设置控制所有系统日志表的默认刷写策略：

<default_system_log_flush_policy>
    <skip_alias_columns>true</skip_alias_columns>
</default_system_log_flush_policy>

设置	描述	默认值
`skip_alias_columns`	为 `true` 时，系统日志表的 schema 中会省略 ALIAS 列。S3 支持的系统日志需要启用此项。	`false`

SQL 参考文档

数据类型

引擎

函数

格式

设置

系统表

数据湖

asynchronous_heavy_metrics_update_period_s

asynchronous_insert_log

asynchronous_metric_log

​asynchronous_heavy_metrics_update_period_s

​asynchronous_insert_log

​asynchronous_metric_log

asynchronous_heavy_metrics_update_period_s

asynchronous_insert_log

asynchronous_metric_log