storage_* サーバー設定 - ClickHouse Documentation

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

storage_configuration

ストレージのマルチディスク構成が可能です。ストレージ構成は次の形式です:

<storage_configuration>
    <disks>
        <!-- configuration -->
    </disks>
    <policies>
        <!-- configuration -->
    </policies>
</storage_configuration>

disks の設定

disks の設定は、以下の構造に従います。

<storage_configuration>
    <disks>
        <disk_name_1>
            <path>/mnt/fast_ssd/clickhouse/</path>
        </disk_name_1>
        <disk_name_2>
            <path>/mnt/hdd1/clickhouse/</path>
            <keep_free_space_bytes>10485760</keep_free_space_bytes>
        </disk_name_2>
        <disk_name_3>
            <path>/mnt/hdd2/clickhouse/</path>
            <keep_free_space_bytes>10485760</keep_free_space_bytes>
        </disk_name_3>
        ...
    </disks>
</storage_configuration>

上記のサブタグでは、disks に対して次の設定を定義します。

Setting	Description
`<disk_name_N>`	ディスクの名前。一意である必要があります。
`path`	サーバーデータ (`data` および `shadow` カタログ) が保存されるパス。末尾は `/` で終わる必要があります
`keep_free_space_bytes`	ディスク上で予約しておく空き領域のサイズ。

ディスクの順序は関係ありません。

policies の設定

上記のサブタグは、policies に対して次の設定を定義します。

Setting	Description
`policy_name_N`	ポリシーの名前です。ポリシー名は一意である必要があります。
`volume_name_N`	ボリューム名です。ボリューム名は一意である必要があります。
`disk`	ボリューム内にあるディスクです。
`max_data_part_size_bytes`	このボリューム内の任意のディスクに配置できるデータ chunk の最大サイズです。merge の結果、chunk サイズが `max_data_part_size_bytes` を超えると見込まれる場合、その chunk は次のボリュームに書き込まれます。つまり、この機能を使うと、新しい / 小さい chunk はホット (SSD) ボリュームに保存し、サイズが大きくなったらコールド (HDD) ボリュームに移動できます。ポリシーにボリュームが 1 つしかない場合は、このオプションを使用しないでください。
`move_factor`	ボリューム上の利用可能な空き領域の割合です。空き領域がこの値を下回ると、次のボリュームがある場合はデータの移動が開始されます。移動対象の chunk はサイズの大きい順 (降順) にソートされ、`move_factor` の条件を満たすのに十分な合計サイズとなる chunk が選択されます。すべての chunk の合計サイズでも不足する場合は、すべての chunk が移動されます。
`perform_ttl_move_on_insert`	INSERT 時に、有効期限切れの TTL を持つデータの移動を無効にします。デフォルトでは (有効な場合) 、move rule に基づいてすでに期限切れになっているデータを insert すると、そのデータは rule で指定されたボリューム / ディスクに即座に移動されます。対象のボリューム / ディスクが低速な場合 (例: S3) 、これにより INSERT が大幅に遅くなることがあります。無効にすると、期限切れのデータ部分はいったんデフォルトのボリュームに書き込まれ、その後すぐに、期限切れの TTL に対する rule で指定されたボリュームへ移動されます。
`load_balancing`	ディスクの負荷分散ポリシーです。`round_robin` または `least_used` を指定します。
`least_used_ttl_ms`	すべてのディスクの利用可能領域を更新する timeout (ミリ秒単位) を設定します (`0` - 常に更新、`-1` - 更新しない、デフォルト値は `60000`) 。なお、ディスクが ClickHouse でのみ使用され、ファイルシステムが実行時にリサイズされることがない場合は、`-1` を使用できます。それ以外のすべてのケースでは推奨されません。最終的に領域割り当てが不正確になるためです。
`prefer_not_to_merge`	このボリューム上でのデータパーツの merging を無効にします。注: これは潜在的に有害であり、速度低下を引き起こす可能性があります。この設定を有効にすると (そうしないでください) 、このボリューム上でのデータの merging が禁止されます (望ましくありません) 。これにより、ClickHouse が低速なディスクとどのようにやり取りするかを制御できます。これはまったく使用しないことを推奨します。
`volume_priority`	ボリュームが埋められる優先順位 (順序) を定義します。値が小さいほど優先順位は高くなります。パラメーター値は自然数でなければならず、1 から N (N は指定されたパラメーター値の最大値) までの範囲を、ギャップなくすべて満たしている必要があります。

volume_priority について:

すべてのボリュームにこのパラメーターがある場合は、指定された順序で優先されます。
一部の ボリュームのみにこれがある場合、これを持たないボリュームの優先順位は最も低くなります。これを持つボリュームはタグ値に従って優先され、残りのボリューム同士の優先順位は、設定ファイル内での記述順によって決まります。
どのボリュームにもこのパラメーターが指定されていない場合、それらの順序は設定ファイルでの記述順によって決まります。
ボリュームの優先順位は同一であってはなりません。

storage_metadata_write_full_object_key

ディスクのメタデータファイルを VERSION_FULL_OBJECT_KEY フォーマットで書き込みます。デフォルトで有効です。この設定は非推奨です。

storage_shared_set_join_use_inner_uuid

有効にすると、SharedSet および SharedJoin の作成時に内部 UUID が生成されます。ClickHouse Cloud のみ

​storage_configuration

​disks の設定

​policies の設定

​storage_metadata_write_full_object_key

​storage_shared_set_join_use_inner_uuid

storage_configuration

disks の設定

policies の設定

storage_metadata_write_full_object_key

storage_shared_set_join_use_inner_uuid