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

# allow_* MergeTree テーブル設定

> allow_* グループに含まれる ClickHouse MergeTree テーブル設定。

export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
  return <div className="not-prose" style={{
    display: "flex",
    flexWrap: "wrap",
    alignItems: "baseline",
    columnGap: "0.5rem",
    rowGap: "0.125rem",
    margin: "0.375rem 0",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <div style={{
    fontWeight: 600,
    opacity: 0.72
  }}>型</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>デフォルト値</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          再起動せずに変更可能
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

export const ExperimentalBadge = () => {
  return <div className="experimentalBadge">
            <div className="experimentalIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path strokeWidth="1.25" d="M5.5 2H10.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.25" d="M9.50015 2V6.19625L13.4283 12.7425C13.4738 12.8183 13.4985 12.9049 13.4996 12.9934C13.5008 13.0818 13.4785 13.169 13.435 13.246C13.3914 13.323 13.3283 13.3871 13.2519 13.4317C13.1755 13.4764 13.0886 13.4999 13.0002 13.5H3.00015C2.91164 13.5 2.8247 13.4766 2.74822 13.432C2.67174 13.3874 2.60847 13.3233 2.56487 13.2463C2.52126 13.1693 2.49889 13.082 2.50004 12.9935C2.50119 12.905 2.52582 12.8184 2.5714 12.7425L6.50015 6.19625V2" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.25" d="M4.47656 9.56754C5.30344 9.41254 6.47656 9.47942 7.99969 10.25C10.0153 11.2707 11.4216 11.0569 12.2184 10.7282" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
        </div>
            実験的な機能です。 <u><a href="/docs/docs/beta-and-experimental-features#experimental-features">詳細を見る。</a></u>
        </div>;
};

これらの設定は [system.merge\_tree\_settings](/docs/ja/reference/system-tables/merge_tree_settings) で参照でき、ClickHouseのソースコードから自動生成されています。

<div id="allow_coalescing_columns_in_partition_or_order_key">
  ## allow\_coalescing\_columns\_in\_partition\_or\_order\_key
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.6"},{"label": "0"},{"label": "パーティションキーまたはソートキーのカラムを coalescing の対象にできるようにする新しい設定。"}]}]} />

有効にすると、CoalescingMergeTree テーブルで、パーティションキーまたはソートキーに含まれるカラムを
coalescing カラムとして使用できるようになります。

<div id="allow_commit_order_projection">
  ## allow\_commit\_order\_projection
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.4"},{"label": "0"},{"label": "新しい設定"}]}]} />

`_block_number` と `_block_offset` の仮想カラムを格納し、マージ後も元の挿入順序を維持する commit-order プロジェクション を有効にします。
これを使用するには、`enable_block_number_column` と `enable_block_offset_column` を有効にする必要があります。

<div id="allow_dimensions_outside_sorting_key">
  ## allow\_dimensions\_outside\_sorting\_key
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "0"},{"label": "AggregatingMergeTree は現在、テーブル作成時に、カラムがソートキーの一部でも集約状態の measure でもないスキーマを拒否します。以前はそのようなスキーマも受け入れられていました（従来の動作は値 'true' に対応します）。"}]}]} />

`AggregatingMergeTree` では、background マージ によってソートキーの値が同じ行が 1 つにまとめられ、それらの aggregate state が結合されます。ソートキーの一部でも aggregate-state の *measure* (`AggregateFunction` または `SimpleAggregateFunction`) でもないカラムは *dimension* です。つまり、マージ 後には、まとめられた行のいずれか 1 行の値が任意に保持されるため、そのカラムに対して `GROUP BY` や filter を行うクエリで、誤った結果が黙って生成される可能性があります ([https://github.com/ClickHouse/ClickHouse/issues/751](https://github.com/ClickHouse/ClickHouse/issues/751) を参照) 。

デフォルトでは、このようなスキーマはテーブル作成時に拒否されます。この設定は、そのカラムがソートキーに関数従属しており (つまり、まとめられるすべての行で同じ値を共有し) 、この動作が意図したものである場合に有効にしてください。

このチェックは、実際に aggregation を行うテーブル (少なくとも 1 つの aggregate-state カラムを持つもの) にのみ適用され、`allow_tuple_element_aggregation` が有効な場合はスキップされます。

<div id="allow_floating_point_partition_key">
  ## allow\_floating\_point\_partition\_key
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

浮動小数点数をパーティションキーとして使用できるようにします。

設定可能な値:

* `0` — 浮動小数点数のパーティションキーは使用できません。
* `1` — 浮動小数点数のパーティションキーを使用できます。

<div id="allow_minmax_index_for_json">
  ## allow\_minmax\_index\_for\_json
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "0"},{"label": "索引のシリアライゼーションで異種の Field 値を扱えないため、デフォルトでは JSON カラムに minmax スキップ索引を作成することを禁止"}]}]} />

JSON (Object) カラムで minmax スキップ索引を作成できるようにします。JSON カラムには異種の Field 値が含まれる可能性があり、minmax
索引のシリアライゼーション処理ではそれを扱えないため、デフォルトでは無効になっています。

<div id="allow_nullable_key">
  ## allow\_nullable\_key
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

主キーとして Nullable 型を使用できるようにします。

<div id="allow_part_offset_column_in_projections">
  ## allow\_part\_offset\_column\_in\_projections
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "1"},{"label": "これで、プロジェクションで _part_offset カラムを使用できるようになりました。"}]}, {"id": "row-2","items": [{"label": "25.5"},{"label": "0"},{"label": "新しい設定。安定化するまで、親パートのオフセットカラムを含むプロジェクションの作成を防ぎます。"}]}]} />

プロジェクションのSELECTクエリで '\_part\_offset' カラムの使用を許可します。

<div id="allow_reduce_blocking_parts_task">
  ## allow\_reduce\_blocking\_parts\_task
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.2"},{"label": "1"},{"label": "SMT はデフォルトで ZooKeeper から古くなったブロッキングパーツを削除するようになりました"}]}, {"id": "row-2","items": [{"label": "25.1"},{"label": "0"},{"label": "Cloud sync"}]}]} />

shared merge tree テーブルのブロッキングパーツを減らすバックグラウンドタスクです。
ClickHouse Cloud でのみ利用できます

<div id="allow_remote_fs_zero_copy_replication">
  ## allow\_remote\_fs\_zero\_copy\_replication
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

まだ準備が整っていないため、この設定を本番環境で使用しないでください。

<div id="allow_summing_columns_in_partition_or_order_key">
  ## allow\_summing\_columns\_in\_partition\_or\_order\_key
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.4"},{"label": "0"},{"label": "パーティションキーまたはソートキーに合計対象カラムを使用できるようにする新しい設定"}]}]} />

有効にすると、SummingMergeTree テーブルの合計対象カラムを
パーティションキーまたはソートキーとして使用できます。

<div id="allow_suspicious_indices">
  ## allow\_suspicious\_indices
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

同一の式を持つプライマリ/セカンダリ索引およびソートキーを拒否します

<div id="allow_tuple_element_aggregation">
  ## allow\_tuple\_element\_aggregation
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "0"},{"label": "新しい設定"}]}]} />

有効にすると、Tupleカラム内の各要素が、SummingMergeTree、AggregatingMergeTree、および
CoalescingMergeTree での
マージ時の集計の対象になります。ネストされた Tuple は再帰的に展開されるため、すべての
末端要素がそれぞれ独立して集計されます。この設定は変更不可であり、
テーブル作成時に指定する必要があります。

<div id="allow_vertical_merges_from_compact_to_wide_parts">
  ## allow\_vertical\_merges\_from\_compact\_to\_wide\_parts
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

compact パーツから wide パーツへの垂直マージを許可します。この設定の値は、すべてのレプリカで同一である必要があります。
