> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-postgresql-tls-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# allow_experimental_* セッション設定

> allow_experimental_* グループに自動生成された ClickHouse のセッション設定。

export const VersionHistory = ({rows = []}) => {
  if (rows.length === 0) {
    return null;
  }
  const headers = ["バージョン", "デフォルト値", "コメント"];
  const border = "1px solid rgba(128, 128, 128, 0.3)";
  const cell = {
    border,
    padding: "0.25rem 0.5rem",
    textAlign: "start",
    verticalAlign: "top"
  };
  return <details className="not-prose" style={{
    border,
    borderRadius: "0.5rem",
    margin: "0.5rem 0",
    padding: "0.5rem 0.75rem",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <summary style={{
    cursor: "pointer",
    fontWeight: 600,
    opacity: 0.72
  }}>
        バージョン履歴
      </summary>
      <table style={{
    borderCollapse: "collapse",
    width: "100%",
    margin: "0.5rem 0 0"
  }}>
        <thead>
          <tr>
            {headers.map(header => <th key={header} style={{
    ...cell,
    fontWeight: 600,
    opacity: 0.72
  }}>
                {header}
              </th>)}
          </tr>
        </thead>
        <tbody>
          {rows.map((row, row_index) => <tr key={row.id ?? row_index}>
              {(row.items ?? []).map((item, item_index) => <td key={item_index} style={{
    ...cell,
    overflowWrap: "anywhere"
  }}>
                  {item?.label}
                </td>)}
            </tr>)}
        </tbody>
      </table>
    </details>;
};

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 BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <span>ベータ</span>
            </a>;
  }
  return <a href="/docs/beta-and-experimental-features#beta-features" className="betaBadge">
            <span>ベータ機能です</span>
        </a>;
};

export const ExperimentalBadge = () => {
  return <a href="/docs/beta-and-experimental-features#experimental-features" 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>
            実験的な機能です
        </a>;
};

これらの設定は [system.settings](/ja/reference/system-tables/settings) で確認でき、[ソースコード](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp) から自動生成されています。

<div id="allow_experimental_ai_functions">
  ## allow\_experimental\_ai\_functions
</div>

<ExperimentalBadge />

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

実験的なAI関数 (例: `aiGenerateContent`) を有効にします。これらの関数は、AIプロバイダに対して外部HTTPリクエストを送信します。

<div id="allow_experimental_analyzer">
  ## allow\_experimental\_analyzer
</div>

**別名**: `enable_analyzer`

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

アナライザを有効にします。

<div id="allow_experimental_cleanup_old_data_files_compaction">
  ## allow\_experimental\_cleanup\_old\_data\_files\_compaction
</div>

<ExperimentalBadge />

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

Iceberg compaction 時に古い data files をクリーンアップできるようにします。

<div id="allow_experimental_codecs">
  ## allow\_experimental\_codecs
</div>

<ExperimentalBadge />

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

true に設定すると、実験的な圧縮 codec を指定できるようになります (ただし、現時点ではそのような codec はまだなく、このオプションは何も行いません) 。

<div id="allow_experimental_correlated_subqueries">
  ## allow\_experimental\_correlated\_subqueries
</div>

<BetaBadge />

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

相関サブクエリを実行できるようにします。

<div id="allow_experimental_database_glue_catalog">
  ## allow\_experimental\_database\_glue\_catalog
</div>

<BetaBadge />

**別名**: `allow_database_glue_catalog`

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

catalog\_type = 'glue' の実験的なデータベースエンジン DataLakeCatalog の使用を許可します

Cloud でのデフォルト値: `1`.

<div id="allow_experimental_database_hms_catalog">
  ## allow\_experimental\_database\_hms\_catalog
</div>

<ExperimentalBadge />

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

catalog\_type = 'hms' の場合に、実験的なデータベースエンジン DataLakeCatalog を有効にします

<div id="allow_experimental_database_iceberg">
  ## allow\_experimental\_database\_iceberg
</div>

<BetaBadge />

**別名**: `allow_database_iceberg`

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

catalog\_type = 'iceberg' の実験的なデータベースエンジン DataLakeCatalog の使用を許可します

Cloud でのデフォルト値: `1`.

<div id="allow_experimental_database_materialized_postgresql">
  ## allow\_experimental\_database\_materialized\_postgresql
</div>

<ExperimentalBadge />

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

Engine=MaterializedPostgreSQL(...) を指定したデータベースの作成を許可します。

<div id="allow_experimental_database_paimon_rest_catalog">
  ## allow\_experimental\_database\_paimon\_rest\_catalog
</div>

<ExperimentalBadge />

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

catalog\_type = 'paimon\_rest' を使用する実験的なデータベースエンジン DataLakeCatalog の使用を許可します

<div id="allow_experimental_database_unity_catalog">
  ## allow\_experimental\_database\_unity\_catalog
</div>

<BetaBadge />

**別名**: `allow_database_unity_catalog`

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

catalog\_type = 'unity' の実験的なデータベースエンジン DataLakeCatalog を有効にします

Cloud でのデフォルト値: `1`.

<div id="allow_experimental_delta_kernel_rs">
  ## allow\_experimental\_delta\_kernel\_rs
</div>

<BetaBadge />

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

delta-kernel-rs の実験的な実装を有効にします。

<div id="allow_experimental_delta_lake_writes">
  ## allow\_experimental\_delta\_lake\_writes
</div>

<BetaBadge />

**別名**: `allow_delta_lake_writes`

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

delta-kernelの書き込み機能を有効にします。

<div id="allow_experimental_eval_table_function">
  ## allow\_experimental\_eval\_table\_function
</div>

<ExperimentalBadge />

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

実験的なテーブル関数 `eval` を有効にします。

<div id="allow_experimental_expire_snapshots">
  ## allow\_experimental\_expire\_snapshots
</div>

<ExperimentalBadge />

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

実験段階の Iceberg コマンド `ALTER TABLE ... EXECUTE expire_snapshots` を実行できるようにします。

<div id="allow_experimental_funnel_functions">
  ## allow\_experimental\_funnel\_functions
</div>

<ExperimentalBadge />

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

ファネル分析の実験的な関数を有効にします。

<div id="allow_experimental_geo_types_in_iceberg">
  ## allow\_experimental\_geo\_types\_in\_iceberg
</div>

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

Iceberg の `geometry` および `geography` フィールド型を、ClickHouse の `Geometry` (Variant) 型としてパースできるようにします。

<div id="allow_experimental_hash_functions">
  ## allow\_experimental\_hash\_functions
</div>

<ExperimentalBadge />

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

実験的なハッシュ関数を有効にする

<div id="allow_experimental_iceberg_compaction">
  ## allow\_experimental\_iceberg\_compaction
</div>

<ExperimentalBadge />

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

Iceberg テーブルで 'OPTIMIZE' を明示的に使用できるようにします。

<div id="allow_experimental_join_right_table_sorting">
  ## allow\_experimental\_join\_right\_table\_sorting
</div>

<ExperimentalBadge />

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

true に設定されており、`join_to_sort_minimum_perkey_rows` と `join_to_sort_maximum_table_rows` の条件を満たす場合、left または inner ハッシュ結合のパフォーマンスを向上させるために、右テーブルをキー順に並べ替えます。

<div id="allow_experimental_json_lazy_type_hints">
  ## allow\_experimental\_json\_lazy\_type\_hints
</div>

<ExperimentalBadge />

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

JSON型で実験的な遅延型ヒントを有効にします。この機能では、型ヒントの評価を後回しにすることで、JSON型の型変換を最適化できます。

<div id="allow_experimental_kafka_offsets_storage_in_keeper">
  ## allow\_experimental\_kafka\_offsets\_storage\_in\_keeper
</div>

<ExperimentalBadge />

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

Kafka 関連のオフセットを ClickHouse Keeper に保存する実験的機能を有効にします。有効にすると、Kafka テーブルエンジン に ClickHouse Keeper パスとレプリカ名を指定できます。これにより、通常の Kafka エンジンの代わりに、コミット済みオフセットを主に ClickHouse Keeper に保存する新しい種類のストレージエンジンが使用されます

<div id="allow_experimental_kusto_dialect">
  ## allow\_experimental\_kusto\_dialect
</div>

<ExperimentalBadge />

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

Kusto Query Language (KQL) を有効にします。SQL の代替となるクエリ言語です。

<div id="allow_experimental_materialized_postgresql_table">
  ## allow\_experimental\_materialized\_postgresql\_table
</div>

<ExperimentalBadge />

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

MaterializedPostgreSQL テーブルエンジンの使用を許可します。この機能は実験的なため、デフォルトでは無効になっています

<div id="allow_experimental_nlp_functions">
  ## allow\_experimental\_nlp\_functions
</div>

<ExperimentalBadge />

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

自然言語処理向けの実験的な関数を有効にします。

<div id="allow_experimental_nullable_tuple_type">
  ## allow\_experimental\_nullable\_tuple\_type
</div>

<BetaBadge />

**別名**: `enable_nullable_tuple_type`

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

テーブルで [Nullable](/ja/reference/data-types/nullable) [Tuple](/ja/reference/data-types/tuple) カラムを作成できるようにします。

この設定では、抽出された Tuple のサブカラムを `Nullable` にできるかどうか (たとえば、Dynamic、Variant、JSON、または Tuple カラムから抽出されたもの) を制御しません。
抽出された Tuple のサブカラムを `Nullable` にできるかどうかを制御するには、`allow_nullable_tuple_in_extracted_subcolumns` を使用してください。

<div id="allow_experimental_object_storage_queue_hive_partitioning">
  ## allow\_experimental\_object\_storage\_queue\_hive\_partitioning
</div>

<ExperimentalBadge />

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

S3Queue/AzureQueue エンジンで Hive パーティション化を使用できるようにします

<div id="allow_experimental_paimon_storage_engine">
  ## allow\_experimental\_paimon\_storage\_engine
</div>

<ExperimentalBadge />

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

Paimon\* テーブルエンジンでテーブルを作成できるようにします。

<div id="allow_experimental_parallel_reading_from_replicas">
  ## allow\_experimental\_parallel\_reading\_from\_replicas
</div>

**別名**: `enable_parallel_replicas`

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

SELECT クエリ実行では、各分片から最大 `max_parallel_replicas` 個のレプリカを使用します。読み取りは並列化され、動的に調整されます。0 - 無効、1 - 有効 (障害時は自動的に無効化) 、2 - 有効 (障害時に例外をスロー)

<div id="allow_experimental_polyglot_dialect">
  ## allow\_experimental\_polyglot\_dialect
</div>

<ExperimentalBadge />

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

polyglot SQL トランスパイラを有効にします。これにより、30種類以上のSQL方言 (MySQL、PostgreSQL、SQLite、Snowflake、DuckDB など) のSQLをClickHouse SQLに変換できます。

<div id="allow_experimental_prql_dialect">
  ## allow\_experimental\_prql\_dialect
</div>

<ExperimentalBadge />

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

SQLの代替となるPRQLを有効にします。

<div id="allow_experimental_time_series_aggregate_functions">
  ## allow\_experimental\_time\_series\_aggregate\_functions
</div>

<ExperimentalBadge />

**別名**: `allow_experimental_ts_to_grid_aggregate_function`

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

Prometheusライクな時系列のリサンプリング、rate、delta の計算に対応する実験的な timeSeries\* 集約関数。

<div id="allow_experimental_time_series_table">
  ## allow\_experimental\_time\_series\_table
</div>

<ExperimentalBadge />

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

[TimeSeries](/ja/reference/engines/table-engines/integrations/time-series) テーブルエンジンを使用するテーブルの作成を許可します。設定可能な値:

* 0 — [TimeSeries](/ja/reference/engines/table-engines/integrations/time-series) テーブルエンジンは無効です。
* 1 — [TimeSeries](/ja/reference/engines/table-engines/integrations/time-series) テーブルエンジンは有効です。

<div id="allow_experimental_unique_key">
  ## allow\_experimental\_unique\_key
</div>

<ExperimentalBadge />

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

MergeTree ファミリーのエンジンで `UNIQUE KEY` 句を使用したテーブルの作成を許可します。

<div id="allow_experimental_url_wildcard_from_index_pages">
  ## allow\_experimental\_url\_wildcard\_from\_index\_pages
</div>

<ExperimentalBadge />

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

HTTPインデックスページを使用して、`url()` および `ENGINE = URL` での実験的なワイルドカード展開を許可します。

<div id="allow_experimental_window_view">
  ## allow\_experimental\_window\_view
</div>

<ExperimentalBadge />

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

WINDOW VIEW を有効にします。まだ十分に安定していません。

<div id="allow_experimental_ytsaurus_dictionary_source">
  ## allow\_experimental\_ytsaurus\_dictionary\_source
</div>

<ExperimentalBadge />

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

YTsaurus とのインテグレーション向けの実験的な Dictionary ソース。

<div id="allow_experimental_ytsaurus_table_engine">
  ## allow\_experimental\_ytsaurus\_table\_engine
</div>

<ExperimentalBadge />

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

YTsaurus とのインテグレーション用の実験的なテーブルエンジン。

<div id="allow_experimental_ytsaurus_table_function">
  ## allow\_experimental\_ytsaurus\_table\_function
</div>

<ExperimentalBadge />

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

YTsaurus とのインテグレーション向けの実験的なテーブルエンジン。