storage_* サーバー設定

storage_* 生成グループの ClickHouse サーバー設定。

これらの設定は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 のみ