asynchronous_* サーバー設定

これらの設定は ClickHouse server を構成するもので、ClickHouse のソースコードから自動生成されています。

asynchronous_heavy_metrics_update_period_s

負荷の高い非同期メトリクスの更新間隔 (秒) 。

asynchronous_insert_log

非同期 INSERT のログを記録する asynchronous_insert_log システムテーブルの設定です。以下の設定はサブタグで設定できます。

Setting	Description	Default	Note
`database`	データベース名。
`table`	システムテーブル名。
`engine`	システムテーブルの MergeTree エンジン定義。		`partition_by` または `order_by` が定義されている場合は使用できません。指定しない場合は、デフォルトで `MergeTree` が選択されます
`partition_by`	システムテーブルのカスタムパーティションキー。		システムテーブルに `engine` を指定する場合、`partition_by` パラメータは ‘engine’ 内に直接指定する必要があります
`ttl`	テーブルの有効期限 (TTL) を指定します。		システムテーブルに `engine` を指定する場合、`ttl` パラメータは ‘engine’ 内に直接指定する必要があります
`order_by`	システムテーブルのカスタムソートキー。`engine` が定義されている場合は使用できません。		システムテーブルに `engine` を指定する場合、`order_by` パラメータは ‘engine’ 内に直接指定する必要があります
`storage_policy`	テーブルに使用するストレージポリシー名 (任意) 。		システムテーブルに `engine` を指定する場合、`storage_policy` パラメータは ‘engine’ 内に直接指定する必要があります
`settings`	MergeTree の動作を制御する追加パラメータ (任意) 。		システムテーブルに `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`

さらに、次のサーバーレベル設定は、すべてのシステムログテーブルに対するデフォルトのフラッシュポリシーを制御します。

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

設定	説明	デフォルト
`skip_alias_columns`	`true` の場合、システムログテーブルのスキーマから 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` を指定する場合、`partition_by` パラメータは ‘engine’ 内に直接指定する必要があります
`ttl`	テーブルの有効期限 (TTL) を指定します。		システムテーブルに `engine` を指定する場合、`ttl` パラメータは ‘engine’ 内に直接指定する必要があります
`order_by`	システムテーブルのカスタムソートキー。`engine` が定義されている場合は使用できません。		システムテーブルに `engine` を指定する場合、`order_by` パラメータは ‘engine’ 内に直接指定する必要があります
`storage_policy`	テーブルに使用するストレージポリシー名 (任意) 。		システムテーブルに `engine` を指定する場合、`storage_policy` パラメータは ‘engine’ 内に直接指定する必要があります
`settings`	MergeTree の動作を制御する追加パラメータ (任意) 。		システムテーブルに `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`

さらに、次のサーバーレベル設定は、すべてのシステムログテーブルに対するデフォルトのフラッシュポリシーを制御します。

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

設定	説明	デフォルト
`skip_alias_columns`	`true` の場合、システムログテーブルのスキーマから 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