ClickHouse/settings.md at 140f5987da4dbbce3ad082f5a84a501ef3d3e346

mirror of https://github.com/ClickHouse/ClickHouse.git synced 2024-12-13 18:02:24 +00:00

Miki Matsumoto 1e15312729 add translated Japanese docs

2024-11-18 11:58:58 +09:00

361 KiB

Raw Blame History

title	sidebar_label	slug	toc_max_heading_level
コア設定	コア設定	/ja/operations/settings/settings	2

すべての設定は、テーブル system.settings で利用可能です。これらの設定は、source から自動生成されています。

add_http_cors_header

タイプ: Bool

デフォルト値: 0

HTTP CORS ヘッダーを追加します。

additional_result_filter

タイプ: String

デフォルト値:

SELECT クエリの結果に適用される追加のフィルター式です。この設定は、いかなるサブクエリにも適用されません。

例

INSERT INTO table_1 VALUES (1, 'a'), (2, 'bb'), (3, 'ccc'), (4, 'dddd');
SElECT * FROM table_1;

┌─x─┬─y────┐
│ 1 │ a    │
│ 2 │ bb   │
│ 3 │ ccc  │
│ 4 │ dddd │
└───┴──────┘

SELECT *
FROM table_1
SETTINGS additional_result_filter = 'x != 2'

┌─x─┬─y────┐
│ 1 │ a    │
│ 3 │ ccc  │
│ 4 │ dddd │
└───┴──────┘

additional_table_filters

タイプ: Map

デフォルト値: {}

指定されたテーブルから読み取った後に適用される追加のフィルター式です。

例

INSERT INTO table_1 VALUES (1, 'a'), (2, 'bb'), (3, 'ccc'), (4, 'dddd');
SELECT * FROM table_1;

┌─x─┬─y────┐
│ 1 │ a    │
│ 2 │ bb   │
│ 3 │ ccc  │
│ 4 │ dddd │
└───┴──────┘

SELECT *
FROM table_1
SETTINGS additional_table_filters = {'table_1': 'x != 2'}

┌─x─┬─y────┐
│ 1 │ a    │
│ 3 │ ccc  │
│ 4 │ dddd │
└───┴──────┘

aggregate_functions_null_for_empty

タイプ: Bool

デフォルト値: 0

クエリ内のすべての集約関数を書き換える機能を有効または無効にします。また、-OrNull サフィックスが追加されます。SQL 標準の互換性のために有効にします。分散クエリの一貫した結果を得るために、クエリのリライトを介して実装されています（count_distinct_implementation 設定に類似）。

可能な値:

0 — 無効。
1 — 有効。

例

次の集約関数を使用したクエリを考えてみます。

SELECT SUM(-1), MAX(0) FROM system.one WHERE 0;

aggregate_functions_null_for_empty = 0 の場合、次の結果が表示されます：

┌─SUM(-1)─┬─MAX(0)─┐
│       0 │      0 │
└─────────┴────────┘

aggregate_functions_null_for_empty = 1 の場合、結果は次のようになります：

┌─SUMOrNull(-1)─┬─MAXOrNull(0)─┐
│          NULL │         NULL │
└───────────────┴──────────────┘

非推奨の LIVE VIEW の作成を許可します。

可能な値:

0 — ライブビューでの操作が無効です。
1 — ライブビューでの操作が有効です。

可能な値:

0 — TimeSeries テーブルエンジンは無効です。
1 — TimeSeries テーブルエンジンは有効です。

可能な値:

1 — インストロスペクション関数有効。
0 — インストロスペクション関数無効。

参照

Sampling Query Profiler
システムテーブル trace_log

allow_materialized_view_with_bad_select

タイプ: Bool

デフォルト値: 1

存在しないテーブルやカラムを参照する SELECT クエリを使用して CREATE MATERIALIZED VIEW を許可します。それは依然として構文的に有効でなければなりません。リフレッシュ可能な MV には適用されません。SELECT クエリから MV スキーマを推測する必要がある場合（すなわち、CREATE にカラムリストがなく TO テーブルがない場合）には適用されません。MV のソーステーブルを作成するために使用できます。

allow_named_collection_override_by_default

タイプ: Bool

デフォルト値: 1

デフォルトで名前付きコレクションのフィールドをオーバーライドすることを許可します。

allow_non_metadata_alters

タイプ: Bool

デフォルト値: 1

テーブルメタデータだけでなく、ディスク上のデータにも影響を与える ALTER を実行することを許可します。

allow_nonconst_timezone_arguments

タイプ: Bool

デフォルト値: 0

toTimeZone()、fromUnixTimestamp*()、snowflakeToDateTime*() のような特定の時間関連関数で非定数のタイムゾーン引数を許可します。

allow_nondeterministic_mutations

タイプ: Bool

デフォルト値: 0

ユーザーレベルの設定で、レプリケートされたテーブルが dictGet のような非決定的関数を使用するための変更を許可します。

例えば、Dictionaryがノード間で同期していない可能性があるため、Dictionaryから値を引っ張る変更がデフォルメでレプリケートされたテーブルでは許可されていません。この設定を有効にすると、この動作が許可されます。このデータがすべてのノード間で同期されていることをユーザーが確認する責任があります。

例

<profiles>
    <default>
        <allow_nondeterministic_mutations>1</allow_nondeterministic_mutations>

        <!-- ... -->
    </default>

    <!-- ... -->

</profiles>

allow_nondeterministic_optimize_skip_unused_shards

タイプ: Bool

デフォルト値: 0

シャーディングキー内の非決定的（例えば、rand または dictGet、後者には更新に関していくつかの注意事項があります）機能を許可します。

可能な値:

0 — 不許可。
1 — 許可。

allow_prefetched_read_pool_for_local_filesystem

タイプ: Bool

デフォルト値: 0

すべての部分がローカルファイルシステムにある場合、プリフェッチスレッドプールを優先します。

allow_prefetched_read_pool_for_remote_filesystem

タイプ: Bool

デフォルト値: 1

すべての部分がリモートファイルシステムにある場合、プリフェッチスレッドプールを優先します。

allow_push_predicate_when_subquery_contains_with

タイプ: Bool

デフォルト値: 1

サブクエリに WITH 句が含まれている場合、プッシュ述語を許可します。

allow_reorder_prewhere_conditions

タイプ: Bool

デフォルト値: 1

WHERE から PREWHERE に条件を移動する際、最適化フィルタリングのためにそれらを再順序にすることを許可します。

allow_settings_after_format_in_insert

タイプ: Bool

デフォルト値: 0

INSERT クエリ内の FORMAT の後に SETTINGS が許可されるかどうかを制御します。これは推奨されておらず、これにより SETTINGS の一部が値として解釈される可能性があります。

例：

INSERT INTO FUNCTION null('foo String') SETTINGS max_threads=1 VALUES ('bar');

しかし、次のクエリは allow_settings_after_format_in_insert のみで機能します：

SET allow_settings_after_format_in_insert=1;
INSERT INTO FUNCTION null('foo String') VALUES ('bar') SETTINGS max_threads=1;

可能な値:

0 — 不許可。
1 — 許可。

8 バイト以下の固定サイズのデータ型と一緒に LowCardinality を使用することを許可または制限します。数値データ型および FixedString(8_bytes_or_less)。

小さな固定値に対して LowCardinality の使用は通常非効率的です。なぜなら、ClickHouse は各行に対して数値インデックスを保存するからです。その結果：

ディスクスペースの使用量が増加する可能性があります。
RAM 消費が高くなる可能性があります。Dictionaryのサイズに依存します。
一部の関数は、追加のコーディング/エンコーディング操作のために遅くなることがあります。

MergeTree エンジンテーブル内でのマージ時間は、上記のすべての理由により増加する可能性があります。

可能な値:

1 — LowCardinality の使用は制限されません。
0 — LowCardinality の使用は制限されます。

可能な値：

0 — 詳細表示を無効にします。
1 — 詳細表示を有効にします。

例

CREATE TABLE test(a Int64, d Date, s String) ENGINE = MergeTree PARTITION BY toYYYYMDECLARE(d) ORDER BY a;
INSERT INTO test VALUES(1, '2021-01-01', '');
INSERT INTO test VALUES(1, '2021-01-01', '');
ALTER TABLE test DETACH PARTITION ID '202101';

ALTER TABLE test ATTACH PARTITION ID '202101' SETTINGS alter_partition_verbose_result = 1;

┌─command_type─────┬─partition_id─┬─part_name────┬─old_part_name─┐
│ ATTACH PARTITION │ 202101       │ 202101_7_7_0 │ 202101_5_5_0  │
│ ATTACH PARTITION │ 202101       │ 202101_8_8_0 │ 202101_6_6_0  │
└──────────────────┴──────────────┴──────────────┴───────────────┘

ALTER TABLE test FREEZE SETTINGS alter_partition_verbose_result = 1;

┌─command_type─┬─partition_id─┬─part_name────┬─backup_name─┬─backup_path───────────────────┬─part_backup_path────────────────────────────────────────────┐
│ FREEZE ALL   │ 202101       │ 202101_7_7_0 │ 8           │ /var/lib/clickhouse/shadow/8/ │ /var/lib/clickhouse/shadow/8/data/default/test/202101_7_7_0 │
│ FREEZE ALL   │ 202101       │ 202101_8_8_0 │ 8           │ /var/lib/clickhouse/shadow/8/ │ /var/lib/clickhouse/shadow/8/data/default/test/202101_8_8_0 │
└──────────────┴──────────────┴──────────────┴─────────────┴───────────────────────────────┴─────────────────────────────────────────────────────────────┘

alter_sync

タイプ: UInt64

デフォルト値: 1

ALTER、OPTIMIZE、または TRUNCATE クエリによってレプリカでのアクションが実行されるのを待つ設定を行うことができます。

可能な値：

0 — 待機しない。
1 — 自分の実行を待つ。
2 — すべてを待つ。

クラウドデフォルト値: 0。

:::note alter_sync は Replicated テーブルにのみ適用され、Replicated でないテーブルの変更には無効です。 :::

analyze_index_with_space_filling_curves

タイプ: Bool

デフォルト値: 1

テーブルのインデックスに空間充填曲線がある場合（例： ORDER BY mortonEncode(x, y) または ORDER BY hilbertEncode(x, y)）、およびクエリがその引数に条件を持つ場合（例： x >= 10 AND x <= 20 AND y >= 20 AND y <= 30）、インデックス分析のために空間充填曲線を使用します。

analyzer_compatibility_join_using_top_level_identifier

タイプ: Bool

デフォルト値: 0

プロジェクションからの JOIN USING での識別子の解決を強制します（例えば、SELECT a + 1 AS b FROM t1 JOIN t2 USING (b) の場合、結合は t1.a + 1 = t2.b によって行われ、t1.b = t2.b ではありません）。

any_join_distinct_right_table_keys

タイプ: Bool

デフォルト値: 0

ANY INNER|LEFT JOIN 操作における従来の ClickHouse サーバの動作を有効にします。

:::note この設定は、従来の JOIN の動作に依存するユースケースがある場合のみ使用してください。 :::

従来の動作が有効な場合：

t1 ANY LEFT JOIN t2 と t2 ANY RIGHT JOIN t1 操作の結果は等しくありません。なぜなら、ClickHouse は多対一の左から右にマッピングされたテーブルキーのロジックを使用するからです。
ANY INNER JOIN 操作の結果は、SEMI LEFT JOIN 操作と同様に、左テーブルのすべての行を含みます。

従来の動作が無効な場合：

t1 ANY LEFT JOIN t2 と t2 ANY RIGHT JOIN t1 操作の結果は等しいことが保証されます。ClickHouse は ANY RIGHT JOIN 操作での一対多のキーのマッピングを提供するロジックを使用するためです。
ANY INNER JOIN 操作の結果は、左および右の両方のテーブルからキーごとに一行を含みます。

可能な値：

0 — 従来の動作が無効。
1 — 従来の動作が有効。

参照:

JOIN の厳密さ

apply_deleted_mask

タイプ: Bool

デフォルト値: 1

論理削除で削除された行をフィルタリングする機能を有効または無効にします。これが無効になっている場合、クエリはこれらの行を読み取ることができます。これはデバッグや「未削除」シナリオに便利です。

apply_mutations_on_fly

タイプ: Bool

デフォルト値: 0

これが真の場合、データ部分にマテリアライズされていない変異（UPDATE および DELETE）が SELECT に適用されます。ClickHouse Cloud のみで利用可能です。

asterisk_include_alias_columns

タイプ: Bool

デフォルト値: 0

ワイルドカードクエリ（SELECT *）のために ALIAS カラムを含めます。

可能な値：

0 - 無効
1 - 有効

asterisk_include_materialized_columns

タイプ: Bool

デフォルト値: 0

ワイルドカードクエリ（SELECT *）のために MATERIALIZED カラムを含めます。

可能な値：

0 - 無効
1 - 有効

タイプ: Bool

デフォルト値: 1

複数のスレッドで Azure マルチパートアップロードを使用します。

azure_check_objects_after_upload

タイプ: Bool

デフォルト値: 0

アップロードが成功したことを確認するために、Azure Blob ストレージにアップロードされた各オブジェクトをチェックします。

azure_create_new_file_on_insert

タイプ: Bool

デフォルト値: 0

Azure エンジンテーブルに各挿入時に新しいファイルを作成することを有効または無効にします。

azure_ignore_file_doesnt_exist

タイプ: Bool

デフォルト値: 0

特定のキーを読み取る際にファイルが存在しない場合、その不在を無視します。

可能な値:

1 — SELECT は空の結果を返します。
0 — SELECT は例外をスローします。

azure_skip_empty_files

タイプ: Bool

デフォルト値: 0

S3 エンジンで空のファイルをスキップするかどうかを有効または無効にします。

可能な値:

0 — 空のファイルが要求されたフォーマットと互換性がない場合、SELECT は例外をスローします。
1 — 空のファイルに対して SELECT は空の結果を返します。

azure_strict_upload_part_size

タイプ: UInt64

デフォルト値: 0

Azure Blob ストレージにマルチパートアップロード中にアップロードするパートの正確なサイズ。

azure_throw_on_zero_files_match

タイプ: Bool

デフォルト値: 0

グロブ拡張ルールに基づいて一致するファイルがゼロの場合にエラーをスローします。

可能な値:

1 — SELECT は例外をスローします。
0 — SELECT は空の結果を返します。

cancel_http_readonly_queries_on_client_close

タイプ: Bool

デフォルト値: 0

クライアントが応答を待たずに接続を閉じるときに HTTP 読取り専用クエリ（例: SELECT）をキャンセルします。

クラウドデフォルト値: 1。

cast_ipv4_ipv6_default_on_conversion_error

タイプ: Bool

デフォルト値: 0

IPv4 への CAST 演算子、IPv6 への CAST 演算子、toIPv4、toIPv6 関数は、変換エラー時に例外をスローする代わりにデフォルト値を返します。

cast_keep_nullable

タイプ: Bool

デフォルト値: 0

CAST 操作における Nullable データ型の保持を有効または無効にします。

設定が有効になっている場合、CAST 関数の引数が Nullable であれば、結果も Nullable 型に変換されます。設定が無効の場合、結果は常に正確に宛先型になります。

可能な値:

0 — CAST 結果は指定された宛先型と正確に一致します。
1 — 引数の型が Nullable の場合、CAST 結果は Nullable(DestinationDataType) に変換されます。

例

以下のクエリは、宛先データ型を正確に返します。

SET cast_keep_nullable = 0;
SELECT CAST(toNullable(toInt32(0)) AS Int32) as x, toTypeName(x);

結果:

┌─x─┬─toTypeName(CAST(toNullable(toInt32(0)), 'Int32'))─┐
│ 0 │ Int32                                             │
└───┴───────────────────────────────────────────────────┘

以下のクエリは、宛先データ型に Nullable 修飾が適用されます。

SET cast_keep_nullable = 1;
SELECT CAST(toNullable(toInt32(0)) AS Int32) as x, toTypeName(x);

結果:

┌─x─┬─toTypeName(CAST(toNullable(toInt32(0)), 'Int32'))─┐
│ 0 │ Nullable(Int32)                                   │
└───┴───────────────────────────────────────────────────┘

参照

CAST 関数

cast_string_to_dynamic_use_inference

タイプ: Bool

デフォルト値: 0

文字列から動的への変換中に型の推論を使用します。

check_query_single_value_result

タイプ: Bool

デフォルト値: 1

MergeTree ファミリーエンジンの CHECK TABLE クエリ結果に対する詳細レベルを定義します。

可能な値:

0 — クエリはテーブルの各データパートのチェックステータスを表示します。
1 — クエリは一般的なテーブルチェックステータスを表示します。

可能な値:

0 — 集計は JIT コンパイルなしで行われます。
1 — 集計は JIT コンパイルを使用して行われます。

参照

min_count_to_compile_aggregate_expression

可能な値:

正の整数。
0 — 無限タイムアウト。

connections_with_failover_max_tries

タイプ: UInt64

デフォルト値: 3

分散テーブルエンジンにおける各レプリカとの接続試行の最大数。

convert_query_to_cnf

タイプ: Bool

デフォルト値: 0

true に設定すると、SELECT クエリが結合標準形（CNF）に変換されます。CNF にクエリを書き換えることで実行が速くなるシナリオがあります（変更の説明についてはこの Github issue を参照してください）。

以下の SELECT クエリが変更されないことに注意してください（デフォルト動作）：

EXPLAIN SYNTAX
SELECT *
FROM
(
    SELECT number AS x
    FROM numbers(20)
) AS a
WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15))
SETTINGS convert_query_to_cnf = false;

結果は次のようになります：

┌─explain────────────────────────────────────────────────────────┐
│ SELECT x                                                       │
│ FROM                                                           │
│ (                                                              │
│     SELECT number AS x                                         │
│     FROM numbers(20)                                           │
│     WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15)) │
│ ) AS a                                                         │
│ WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15))     │
│ SETTINGS convert_query_to_cnf = 0                              │
└────────────────────────────────────────────────────────────────┘

convert_query_to_cnf を true に設定して、変更を確認しましょう：

EXPLAIN SYNTAX
SELECT *
FROM
(
    SELECT number AS x
    FROM numbers(20)
) AS a
WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15))
SETTINGS convert_query_to_cnf = true;

WHERE 句が CNF で書き換えられていることに気づきますが、結果セットは同じです。論理は変更されていません：

┌─explain───────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ SELECT x                                                                                                              │
│ FROM                                                                                                                  │
│ (                                                                                                                     │
│     SELECT number AS x                                                                                                │
│     FROM numbers(20)                                                                                                  │
│     WHERE ((x <= 15) OR (x <= 5)) AND ((x <= 15) OR (x >= 1)) AND ((x >= 10) OR (x <= 5)) AND ((x >= 10) OR (x >= 1)) │
│ ) AS a                                                                                                                │
│ WHERE ((x >= 10) OR (x >= 1)) AND ((x >= 10) OR (x <= 5)) AND ((x <= 15) OR (x >= 1)) AND ((x <= 15) OR (x <= 5))     │
│ SETTINGS convert_query_to_cnf = 1                                                                                     │
└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

可能な値: true, false

count_distinct_implementation

タイプ: String

タイプ: Bool

デフォルト値: 0

カラム定義に明示的な修飾子 NULL または NOT NULL がないデータ型が Nullable であることを許可します。

可能な値:

1 — カラム定義のデータ型がデフォルトで Nullable に設定されます。
0 — カラム定義のデータ型がデフォルトで Nullable ではないように設定されます。

database_atomic_wait_for_drop_and_detach_synchronously

タイプ: Bool

デフォルト値: 0

すべての DROP および DETACH クエリに SYNC 修飾子を追加します。

可能な値:

0 — クエリは遅延して実行されます。
1 — クエリは遅延なしで実行されます。

database_replicated_initial_query_timeout_sec

タイプ: UInt64

デフォルト値: 300

初期 DDL クエリが複製データベースにおいて前の DDL キューエントリを処理するのを待つ時間を秒単位で設定します。

可能な値:

正の整数。
0 — 無限。

decimal_check_overflow

タイプ: Bool

デフォルト値: 1

小数の算術/比較操作のオーバーフローをチェックします。

deduplicate_blocks_in_dependent_materialized_views

タイプ: Bool

デフォルト値: 0

Replicated* テーブルからデータを受け取るマテリアライズドビューに対する重複排除チェックを有効または無効にします。

可能な値：

0 — 無効。 1 — 有効。

使用

デフォルトでは、マテリアライズドビューに対する重複排除は行われませんが、ソーステーブルで行われます。ソーステーブルで重複排除のために挿入されたブロックがスキップされると、付随的なマテリアライズドビューへの挿入は行われません。この動作は、集約されたデータが異なる INSERT から得られている場合でもマテリアライズドビューに挿入できることを可能にします。同時に、この挙動は INSERT の冪等性を「破ります」。主テーブルへの INSERT が成功し、マテリアライズドビューへの INSERT が失敗した場合（例: ClickHouse Keeper との通信に失敗）、クライアントはエラーを受け取り操作を再試行できます。しかし、最初の失敗により失われた行を挿入することは、ソーステーブルの重複排除によって棄却されます。設定 deduplicate_blocks_in_dependent_materialized_views は、この動作を変更することを可能にします。再試行時に、マテリアライズドビューは再挿入を受け取り、自身で重複排除チェックを行います。ソーステーブルのチェック結果を無視し、最初の失敗により失った行を挿入します。

default_materialized_view_sql_security

タイプ: SQLSecurityType

デフォルト値: DEFINER

マテリアライズドビュー作成時に SQL SECURITY オプションのデフォルト値を設定することを許可します。 SQL セキュリティの詳細

デフォルト値は DEFINER です。

default_max_bytes_in_join

タイプ: UInt64

デフォルト値: 1000000000

制限が必要な場合、右側のテーブルの最大サイズ。ただし max_bytes_in_join が設定されていない場合。

default_normal_view_sql_security

タイプ: SQLSecurityType

デフォルト値: INVOKER

通常のビューを作成する際のデフォルト SQL SECURITY オプションを設定することを許可します。 SQL セキュリティの詳細。

デフォルト値は INVOKER です。

default_table_engine

タイプ: DefaultTableEngine

デフォルト値: MergeTree

CREATE 文で ENGINE が設定されていない場合のデフォルトテーブルエンジン。

可能な値:

有効なテーブルエンジン名を表す文字列。

クラウドのデフォルト値: SharedMergeTree。

例

クエリ：

SET default_table_engine = 'Log';

SELECT name, value, changed FROM system.settings WHERE name = 'default_table_engine';

結果：

┌─name─────────────────┬─value─┬─changed─┐
│ default_table_engine │ Log   │       1 │
└──────────────────────┴───────┴─────────┘

この例では、エンジンを指定していない新しいテーブルは、Log テーブルエンジンを使用します：

クエリ：

CREATE TABLE my_table (
    x UInt32,
    y UInt32
);

SHOW CREATE TABLE my_table;

結果：

┌─statement────────────────────────────────────────────────────────────────┐
│ CREATE TABLE default.my_table
(
    `x` UInt32,
    `y` UInt32
)
ENGINE = Log
└──────────────────────────────────────────────────────────────────────────┘

default_temporary_table_engine

タイプ: DefaultTableEngine

デフォルト値: Memory

一時テーブルのための default_table_engine と同じ。

この例では、エンジンを指定していない新しい一時テーブルは、Log テーブルエンジンを使用します：

クエリ：

SET default_temporary_table_engine = 'Log';

CREATE TEMPORARY TABLE my_table (
    x UInt32,
    y UInt32
);

SHOW CREATE TEMPORARY TABLE my_table;

結果：

┌─statement────────────────────────────────────────────────────────────────┐
│ CREATE TEMPORARY TABLE default.my_table
(
    `x` UInt32,
    `y` UInt32
)
ENGINE = Log
└──────────────────────────────────────────────────────────────────────────┘

default_view_definer

タイプ: String

タイプ: Bool

デフォルト値: 0

挿入データのバッチ送信を有効または無効にします。

バッチ送信が有効な場合、Distributed テーブルエンジンは、挿入データの複数のファイルを1つの操作で送信しようとします。バッチ送信はネットワークおよびサーバーリソースの効率を高め、クラスターのパフォーマンスを向上させます。

可能な値：

1 — 有効。
0 — 無効。

distributed_background_insert_max_sleep_time_ms

タイプ: ミリ秒

デフォルト値: 30000

分散テーブルエンジンがデータを送信するための最大間隔です。これは、distributed_background_insert_sleep_time_ms設定で設定された間隔の指数的な成長を制限します。

可能な値:

正の整数のミリ秒。

distributed_background_insert_sleep_time_ms

タイプ: ミリ秒

デフォルト値: 100

分散テーブルエンジンがデータを送信するための基本間隔です。エラーが発生した場合、実際の間隔は指数的に増加します。

可能な値:

正の整数のミリ秒。

distributed_background_insert_split_batch_on_failure

タイプ: ブール

デフォルト値: 0

失敗時にバッチを分割するかどうかを有効または無効にします。

特定のバッチをリモートシャードに送信する際に、Memory limit exceededや類似のエラーによって失敗することがあります。この場合、リトライしても解決しない(このためテーブルの分散送信が停止します)が、そのバッチからのファイルを1つずつ送信してINSERTを成功させることができるかもしれません。

したがって、この設定を1にすると、そのようなバッチについてバッチ処理を無効にします（すなわち、失敗したバッチのために一時的にdistributed_background_insert_batchを無効化します）。

可能な値:

1 — 有効。
0 — 無効。

デフォルト値: 1024

分散されたすべてのクエリを単一のDistributedテーブルに対してリモートサーバーとの同時接続の最大数です。クラスタ内のサーバーの数以上の値を設定することをお勧めします。

distributed_ddl_entry_format_version

タイプ: UInt64

デフォルト値: 5

分散DDL (ON CLUSTER)クエリの互換性バージョンです。

distributed_ddl_output_mode

タイプ: DistributedDDLOutputMode

デフォルト値: throw

分散DDLクエリ結果のフォーマットを設定します。

可能な値:

throw — クエリが終了したすべてのホストに対してクエリ実行ステータスを持つ結果セットを返します。クエリが一部のホストで失敗した場合、最初の例外を再スローします。すべてのホストでクエリがまだ終了していない場合、distributed_ddl_task_timeoutを超えた場合、TIMEOUT_EXCEEDED例外をスローします。
none — throwに似ていますが、分散DDLクエリは結果セットを返しません。
null_status_on_timeout — 一部の結果セットの行で実行ステータスとしてNULLを返します。これは、クエリが対応するホストでまだ終了していない場合、TIMEOUT_EXCEEDEDをスローするのではなく返します。
never_throw — TIMEOUT_EXCEEDEDをスローせず、一部のホストでクエリが失敗した場合も例外を再スローしません。
none_only_active — noneに似ていますが、Replicatedデータベースの非アクティブなレプリカを待ちません。注意: このモードでは、クエリが一部のレプリカで実行されないことを特定することはできず、バックグラウンドで実行されます。
null_status_on_timeout_only_active — null_status_on_timeoutに似ていますが、Replicatedデータベースの非アクティブなレプリカを待ちません。
throw_only_active — throwに似ていますが、Replicatedデータベースの非アクティブなレプリカを待ちません。

クラウドのデフォルト値: none。

distributed_ddl_task_timeout

タイプ: Int64

デフォルト値: 180

クラスタ内のすべてのホストからのDDLクエリ応答のタイムアウトを設定します。すべてのホストでDDLリクエストが実行されなかった場合、応答にはタイムアウトエラーが含まれ、リクエストは非同期モードで実行されます。負の値は無限を意味します。

可能な値:

正の整数。
0 — 非同期モード。
負の整数 — 無限タイムアウト。

distributed_foreground_insert

タイプ: ブール

デフォルト値: 0

分散テーブルへの同期データ挿入を有効または無効にします。

デフォルトでは、Distributedテーブルにデータを挿入する際にClickHouseサーバーはバックグラウンドモードでクラスターノードにデータを送信します。distributed_foreground_insert=1の場合、データは同期処理され、すべてのデータがすべてのシャードに保存されるまでINSERT操作は成功しません（internal_replicationがtrueの場合、各シャードに少なくとも1つのレプリカが必要です）。

可能な値:

0 — データはバックグラウンドモードで挿入されます。
1 — データは同期モードで挿入されます。

クラウドのデフォルト値: 1。

関連項目

distributed_group_by_no_merge

タイプ: UInt64

デフォルト値: 0

分散クエリ処理のために異なるサーバーからの集計状態をマージしないようにします。異なるシャードに異なるキーがあることが確実な場合に使用できます。

可能な値:

0 — 無効（最終クエリ処理はイニシエータノードで行われます）。
1 - 異なるサーバーからの集計状態をマージせずに分散クエリ処理を行います（クエリはシャード上で完全に処理され、イニシエータはデータをリレーします）。これは、異なるシャードに異なるキーがあることが確実な場合に使用できます。
2 - 1と同じですが、イニシエータの上でORDER BYとLIMITを適用します（クエリがリモートノードで完全に処理される場合には不可能です。例: distributed_group_by_no_merge=1）。

例

SELECT *
FROM remote('127.0.0.{2,3}', system.one)
GROUP BY dummy
LIMIT 1
SETTINGS distributed_group_by_no_merge = 1
FORMAT PrettyCompactMonoBlock

┌─dummy─┐
│     0 │
│     0 │
└───────┘

SELECT *
FROM remote('127.0.0.{2,3}', system.one)
GROUP BY dummy
LIMIT 1
SETTINGS distributed_group_by_no_merge = 2
FORMAT PrettyCompactMonoBlock

┌─dummy─┐
│     0 │
└───────┘

distributed_insert_skip_read_only_replicas

タイプ: ブール

デフォルト値: 0

DistributedへのINSERTクエリ用に読み取り専用レプリカをスキップすることを有効または無効にします。

可能な値:

0 — 通常通りINSERTが行われ、読み取り専用レプリカに送信されると失敗します。
1 — イニシエータはデータをシャードに送信する前に、読み取り専用レプリカをスキップします。

distributed_product_mode

タイプ: DistributedProductMode

デフォルト値: deny

分散サブクエリの動作を変更します。

ClickHouseは、クエリが分散テーブルの非GLOBALサブクエリを含む場合にこの設定を適用します。

制限:

INおよびJOINサブクエリにのみ適用されます。
FROMセクションが複数のシャードを含む分散テーブルを使用している場合にのみ適用されます。
サブクエリが複数のシャードを含む分散テーブルに関係する場合。
テーブル値remote関数には使用されません。

可能な値:

deny — デフォルト値。これらのタイプのサブクエリの使用を禁止します（「Double-distributed in/JOIN subqueries is denied」例外を返します）。
local — サブクエリ内のデータベースとテーブルを宛先サーバー（シャード）のローカルテーブルに置き換えます（通常のIN/JOINを置き換えます）。
global — IN/JOINクエリをGLOBAL IN/GLOBAL JOINに置き換えます。
allow — これらのタイプのサブクエリの使用を許可します。

distributed_push_down_limit

タイプ: UInt64

デフォルト値: 1

各シャードに別々にLIMITを適用するかどうかを有効または無効にします。

これにより、次のことを回避できます：

ネットワーク越しに追加の行を送信すること。
イニシエータでリミットの後に行を処理すること。

21.9バージョンから、少なくとも1つの条件が満たされた場合にのみdistributed_push_down_limitがクエリ実行を変更します:

distributed_group_by_no_merge > 0。
クエリがGROUP BY/DISTINCT/LIMIT BYを持たず、ですがORDER BY/LIMITを持つ。
クエリがORDER BY/LIMITを持つGROUP BY/DISTINCT/LIMIT BYを持ち、且つ：
- optimize_skip_unused_shardsが有効です。
- optimize_distributed_group_by_sharding_keyが有効です。

可能な値:

0 — 無効。
1 — 有効。

関連項目:

distributed_group_by_no_merge
optimize_skip_unused_shards
optimize_distributed_group_by_sharding_key

distributed_replica_error_cap

タイプ: UInt64

デフォルト値: 1000

タイプ: 符号なし整数
デフォルト値: 1000

各レプリカのエラー数がこの値に制限され、1つのレプリカがあまりにも多くのエラーを蓄積するのを防ぎます。

関連項目:

load_balancing
テーブルエンジン分散
distributed_replica_error_half_life
distributed_replica_max_ignored_errors

distributed_replica_error_half_life

タイプ: 秒

デフォルト値: 60

タイプ: 秒
デフォルト値: 60秒

分散テーブルでのエラーがゼロになる速度を制御します。レプリカがしばらく利用できない場合、5つのエラーを蓄積し、distributed_replica_error_half_lifeが1秒に設定されている場合、最後のエラーの後3秒後にレプリカは正常と見なされます。

関連項目:

load_balancing
テーブルエンジン分散
distributed_replica_error_cap
distributed_replica_max_ignored_errors

distributed_replica_max_ignored_errors

タイプ: UInt64

デフォルト値: 0

タイプ: 符号なし整数
デフォルト値: 0

レプリカを選択する際に無視されるエラーの数（load_balancingアルゴリズムに従って）。

関連項目:

load_balancing
テーブルエンジン分散
distributed_replica_error_cap
distributed_replica_error_half_life

Date32は、toStartOfYear、toStartOfISOYear、toStartOfQuarter、toStartOfMonth、toLastDayOfMonth、toStartOfWeek、toLastDayOfWeek、およびtoMondayの関数に対して拡張された範囲（Date型と比較して）。
DateTime64は、toStartOfDay、toStartOfHour、toStartOfMinute、toStartOfFiveMinutes、toStartOfTenMinutes、toStartOfFifteenMinutes、およびtimeSlotの関数に対して拡張された範囲（DateTime型と比較して）。

可能な値:

0 — 関数はすべての型の引数に対してDateまたはDateTimeを返します。
1 — 関数はDate32またはDateTime64引数に対してDate32またはDateTime64を返し、そうでない場合はDateまたはDateTimeを返します。

詳細については、HTTPインターフェースの説明を参照してください。

可能な値:

0 — 無効。
1 — 有効。

述語プッシュダウンは、分散クエリでのネットワークトラフィックを大幅に削減する可能性があります。

可能な値:

0 — 無効。
1 — 有効。

使用法

次のクエリを考えてみてください：

SELECT count() FROM test_table WHERE date = '2018-10-10'
SELECT count() FROM (SELECT * FROM test_table) WHERE date = '2018-10-10'

enable_optimize_predicate_expression = 1の場合、これらのクエリの実行時間は等しくなります。ClickHouseはサブクエリを処理する際にWHEREを適用します。

enable_optimize_predicate_expression = 0の場合、2番目のクエリの実行時間ははるかに長くなります。なぜなら、サブクエリが終了した後で、WHERE句がすべてのデータに適用されるからです。

enable_optimize_predicate_expression_to_final_subquery

タイプ: ブール

デフォルト値: 1

最終サブクエリに述語のプッシュを許可します。

enable_order_by_all

タイプ: ブール

デフォルト値: 1

ORDER BY ALL構文を使用したソートを有効または無効にします。詳細はORDER BYを参照してください。

可能な値:

0 — ORDER BY ALLを無効にします。
1 — ORDER BY ALLを有効にします。

例

クエリ:

CREATE TABLE TAB(C1 Int, C2 Int, ALL Int) ENGINE=Memory();

INSERT INTO TAB VALUES (10, 20, 30), (20, 20, 10), (30, 10, 20);

SELECT * FROM TAB ORDER BY ALL; -- ALLが曖昧であるというエラーが返されます。

SELECT * FROM TAB ORDER BY ALL SETTINGS enable_order_by_all = 0;

結果:

┌─C1─┬─C2─┬─ALL─┐
│ 20 │ 20 │  10 │
│ 30 │ 10 │  20 │
│ 10 │ 20 │  30 │
└────┴─────┴───────┘

enable_parsing_to_custom_serialization

タイプ: ブール

デフォルト値: 1

真の場合、データはテーブルから得られたシリアル化のヒントに従ってカスタムシリアル化（例：Sparse）を持つ列に直接解析されます。

enable_positional_arguments

タイプ: ブール

デフォルト値: 1

GROUP BY、LIMIT BY、ORDER BYステートメントに対する位置引数をサポートするかどうかを有効または無効にします。

可能な値:

0 — 位置引数はサポートされません。
1 — 位置引数がサポートされます: 列番号を列名の代わりに使用できます。

例

クエリ:

CREATE TABLE positional_arguments(one Int, two Int, three Int) ENGINE=Memory();

INSERT INTO positional_arguments VALUES (10, 20, 30), (20, 20, 10), (30, 10, 20);

SELECT * FROM positional_arguments ORDER BY 2,3;

結果:

┌─one─┬─two─┬─three─┐
│  30 │  10 │   20  │
│  20 │  20 │   10  │
│  10 │  20 │   30  │
└─────┴─────┴───────┘

enable_reads_from_query_cache

タイプ: ブール

デフォルト値: 1

オンの場合、SELECTクエリの結果はクエリキャッシュから取得されます。

可能な値:

0 - 無効
1 - 有効

デフォルトでオンです。

enable_vertical_final

タイプ: ブール

デフォルト値: 1

これを有効にすると、最終的に行をマージするのではなく、削除されたとして行をマークし、後でフィルタリングして重複行を削除します。

enable_writes_to_query_cache

タイプ: ブール

デフォルト値: 1

オンの場合、SELECTクエリの結果はクエリキャッシュに格納されます。

可能な値:

0 - 無効
1 - 有効

enable_zstd_qat_codec

タイプ: ブール

デフォルト値: 0

オンの場合、ZSTD_QATコーデックを使用して列を圧縮できます。

enforce_strict_identifier_format

タイプ: ブール

デフォルト値: 0

有効な場合、英数字とアンダースコアを含む識別子のみを許可します。

engine_file_allow_create_multiple_files

タイプ: ブール

デフォルト値: 0

ファイルエンジンのテーブルで、フォーマットがサフィックス（JSON、ORC、Parquetなど）を持つ場合、各挿入時に新しいファイルを作成することを有効または無効にします。有効な場合、各挿入ごとに次のパターンに従った名前の新しいファイルが作成されます：

data.Parquet -> data.1.Parquet -> data.2.Parquet など。

可能な値:

0 — INSERTクエリはファイルの末尾に新しいデータを追加します。
1 — INSERTクエリは新しいファイルを作成します。

engine_file_empty_if_not_exists

タイプ: ブール

デフォルト値: 0

ファイルのないファイルエンジンテーブルからデータを選択することを許可します。

可能な値:

0 — SELECTは例外をスローします。
1 — SELECTは空の結果を返します。

engine_file_skip_empty_files

タイプ: ブール

デフォルト値: 0

Fileエンジンのテーブルで空のファイルをスキップすることを有効または無効にします。

可能な値:

0 — 空のファイルが要求されたフォーマットに適合しない場合、SELECTは例外をスローします。
1 — 空のファイルの場合、SELECTは空の結果を返します。

engine_file_truncate_on_insert

タイプ: ブール

デフォルト値: 0

Fileエンジンのテーブルで、挿入時に切り捨てを有効または無効にします。

可能な値:

0 — INSERTクエリはファイルの末尾に新しいデータを追加します。
1 — INSERTクエリは新しいデータでファイルの既存の内容を置き換えます。

engine_url_skip_empty_files

タイプ: ブール

デフォルト値: 0

URLエンジンのテーブルで空のファイルをスキップすることを有効または無効にします。

可能な値:

0 — 空のファイルが要求されたフォーマットに適合しない場合、SELECTは例外をスローします。
1 — 空のファイルの場合、SELECTは空の結果を返します。

except_default_mode

タイプ: ブール

デフォルト値: 1

更新されたデータが利用できない場合、古いレプリカに対してクエリを強制します。レプリケーションを参照してください。

ClickHouseは、テーブルの古いレプリカの中から最も関連性の高いものを選択します。

これは、レプリケーションされたテーブルを指す分散テーブルからのSELECTを実行する際に使用されます。

デフォルトでは1（有効）です。

タイプ: Bool

デフォルト値: 0

クエリ内のすべてのテーブルに自動的にFINAL修飾子を適用し、FINALが適用可能なテーブル、結合テーブルおよびサブクエリ内のテーブル、分散テーブルにも適用される。

可能な値:

0 - 無効
1 - 有効

例:

CREATE TABLE test
(
    key Int64,
    some String
)
ENGINE = ReplacingMergeTree
ORDER BY key;

INSERT INTO test FORMAT Values (1, 'first');
INSERT INTO test FORMAT Values (1, 'second');

SELECT * FROM test;
┌─key─┬─some───┐
│   1 │ second │
└─────┴────────┘
┌─key─┬─some──┐
│   1 │ first │
└─────┴───────┘

SELECT * FROM test SETTINGS final = 1;
┌─key─┬─some───┐
│   1 │ second │
└─────┴────────┘

SET final = 1;
SELECT * FROM test;
┌─key─┬─some───┐
│   1 │ second │
└─────┴────────┘

flatten_nested

タイプ: Bool

デフォルト値: 1

ネストカラムのデータ形式を設定します。

可能な値:

1 — ネストされたカラムは別々の配列にフラット化される。
0 — ネストされたカラムはタプルの単一配列のままとなる。

使用法

設定が0に設定されている場合、任意のネストレベルを使用することができます。

例

クエリ:

SET flatten_nested = 1;
CREATE TABLE t_nest (`n` Nested(a UInt32, b UInt32)) ENGINE = MergeTree ORDER BY tuple();

SHOW CREATE TABLE t_nest;

結果:

┌─statement───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ CREATE TABLE default.t_nest
(
    `n.a` Array(UInt32),
    `n.b` Array(UInt32)
)
ENGINE = MergeTree
ORDER BY tuple()
SETTINGS index_granularity = 8192 │
└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

クエリ:

SET flatten_nested = 0;

CREATE TABLE t_nest (`n` Nested(a UInt32, b UInt32)) ENGINE = MergeTree ORDER BY tuple();

SHOW CREATE TABLE t_nest;

結果:

┌─statement──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ CREATE TABLE default.t_nest
(
    `n` Nested(a UInt32, b UInt32)
)
ENGINE = MergeTree
ORDER BY tuple()
SETTINGS index_granularity = 8192 │
└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

force_aggregate_partitions_independently

タイプ: Bool

デフォルト値: 0

適用可能な場合に最適化の使用を強制しますが、ヒューリスティックの判断により使用されない場合があります。

force_aggregation_in_order

タイプ: Bool

デフォルト値: 0

この設定は、サーバー自身が分散クエリをサポートするために使用します。通常の操作を破るため、手動で変更しないでください。（分散集計中にリモートノードで順序での集計の使用を強制します）。

force_data_skipping_indices

タイプ: String

デフォルト値:

指定されたデータスキッピングインデックスが使用されない場合、クエリの実行を無効にします。

以下の例を考えてみてください。

CREATE TABLE data
(
    key Int,
    d1 Int,
    d1_null Nullable(Int),
    INDEX d1_idx d1 TYPE minmax GRANULARITY 1,
    INDEX d1_null_idx assumeNotNull(d1_null) TYPE minmax GRANULARITY 1
)
Engine=MergeTree()
ORDER BY key;

SELECT * FROM data_01515;
SELECT * FROM data_01515 SETTINGS force_data_skipping_indices=''; -- クエリは CANNOT_PARSE_TEXT エラーを生成します。
SELECT * FROM data_01515 SETTINGS force_data_skipping_indices='d1_idx'; -- クエリは INDEX_NOT_USED エラーを生成します。
SELECT * FROM data_01515 WHERE d1 = 0 SETTINGS force_data_skipping_indices='d1_idx'; -- Ok.
SELECT * FROM data_01515 WHERE d1 = 0 SETTINGS force_data_skipping_indices='`d1_idx`'; -- Ok （完全なパーサの例）。
SELECT * FROM data_01515 WHERE d1 = 0 SETTINGS force_data_skipping_indices='`d1_idx`, d1_null_idx'; -- d1_null_idx が使用されていないため、クエリは INDEX_NOT_USED エラーを生成します。
SELECT * FROM data_01515 WHERE d1 = 0 AND assumeNotNull(d1_null) = 0 SETTINGS force_data_skipping_indices='`d1_idx`, d1_null_idx'; -- Ok.

force_grouping_standard_compatibility

タイプ: Bool

デフォルト値: 1

GROUPING 関数が引数が集約キーとして使用されていない場合に 1 を返すようにします。

force_index_by_date

タイプ: Bool

デフォルト値: 0

インデックスが日付によって使用できない場合、クエリの実行を無効にします。

MergeTree ファミリーのテーブルで機能します。

force_index_by_date=1の場合、ClickHouse は、クエリにデータ範囲を制限するために使用できる日付キー条件があるかどうかを確認します。適切な条件がない場合、例外がスローされます。ただし、条件が読み取るデータ量を減少させるかどうかは確認しません。たとえば、条件 Date != ' 2000-01-01 ' は、テーブル内のすべてのデータに一致する場合でも受け入れられます（つまり、クエリの実行にフルスキャンが必要です）。MergeTree テーブル内のデータ範囲の詳細については、MergeTreeを参照してください。

force_optimize_projection

タイプ: Bool

デフォルト値: 0

SELECT クエリ内でプロジェクションの必須使用を有効または無効にします。プロジェクション最適化が有効な場合（optimize_use_projections設定を参照）。

可能な値:

0 — プロジェクション最適化は必須ではありません。
1 — プロジェクション最適化は必須です。

force_optimize_projection_name

タイプ: String

デフォルト値:

非空の文字列に設定されている場合、このプロジェクションがクエリ内で少なくとも一度使用されていることを確認します。

可能な値:

文字列: クエリ内で使用されるプロジェクションの名前

force_optimize_skip_unused_shards

タイプ: UInt64

デフォルト値: 0

optimize_skip_unused_shards が有効で、未使用のシャードをスキップできない場合にクエリの実行を有効または無効にします。スキップが不可能で、設定が有効な場合は、例外がスローされます。

可能な値:

0 — 無効。ClickHouse は例外をスローしません。
1 — 有効。テーブルにシャーディングキーがある場合のみクエリの実行が無効になります。
2 — 有効。テーブルにシャーディングキーが定義されているかどうかにかかわらず、クエリの実行が無効になります。

force_optimize_skip_unused_shards_nesting

タイプ: UInt64

デフォルト値: 0

分散クエリのネストレベルに応じてforce_optimize_skip_unused_shardsを制御します（別のDistributedテーブルが別のDistributedテーブルを参照している場合）。

可能な値:

0 - 無効。force_optimize_skip_unused_shardsは常に機能します。
1 — 最初のレベルのみに対してforce_optimize_skip_unused_shardsを有効にします。
2 — 第二レベルまでforce_optimize_skip_unused_shardsを有効にします。

force_primary_key

タイプ: Bool

デフォルト値: 0

function_implementation

タイプ: String

デフォルト値:

特定のターゲットまたはバリアントの関数実装を選択します（エクスペリメンタル）。空の場合はすべて有効になります。

function_json_value_return_type_allow_complex

タイプ: Bool

デフォルト値: 0

json_value 関数に対して複雑なタイプ（構造体、配列、マップなど）の返却を許可するか制御します。

SELECT JSON_VALUE('{"hello":{"world":"!"}}', '$.hello') settings function_json_value_return_type_allow_complex=true

┌─JSON_VALUE('{"hello":{"world":"!"}}', '$.hello')─┐
│ {"world":"!"}                                    │
└──────────────────────────────────────────────────┘

1 row in set. Elapsed: 0.001 sec.

可能な値:

true — 許可。
false — 不許可。

function_json_value_return_type_allow_nullable

タイプ: Bool

デフォルト値: 0

JSON_VALUE 関数に対して値が存在しない場合にNULLを返すことを許可するか制御します。

SELECT JSON_VALUE('{"hello":"world"}', '$.b') settings function_json_value_return_type_allow_nullable=true;

┌─JSON_VALUE('{"hello":"world"}', '$.b')─┐
│ ᴺᵁᴸᴸ                                   │
└────────────────────────────────────────┘

1 row in set. Elapsed: 0.001 sec.

可能な値:

true — 許可。
false — 不許可。

function_locate_has_mysql_compatible_argument_order

タイプ: Bool

デフォルト値: 1

関数locateの引数の順序を制御します。

可能な値:

0 — 関数 locate は引数 (haystack, needle[, start_pos])を受け入れます。
1 — 関数 locate は引数 (needle, haystack, [, start_pos])（MySQL互換の動作）を受け入れます。

function_range_max_elements_in_block

タイプ: UInt64

デフォルト値: 500000000

関数rangeによって生成されるデータボリュームの安全閾値を設定します。データブロックごとに関数によって生成される値の最大数（ブロック内のすべての行の配列サイズの合計）を定義します。

可能な値:

正の整数。

参照も参照

max_block_size
min_insert_block_size_rows

可能な値:

0 — 集約キータイプのデフォルト値が欠落値を生成するために使用されます。
1 — ClickHouse は SQL 標準で述べられている通りに GROUP BY を実行します。集約キーのタイプはNullableに変換されます。該当する集約キーの列は、使用されなかった行のNULLで満たされます。

参照も参照:

GROUP BY句

handshake_timeout_ms

タイプ: ミリ秒

デフォルト値: 10000

ハンドシェイク中にレプリカから Hello パケットを受信するためのタイムアウト（ミリ秒）。

hdfs_create_new_file_on_insert

タイプ: Bool

デフォルト値: 0

HDFS エンジンテーブルに対する各挿入時に新しいファイルを作成するかどうかを有効または無効にします。有効な場合、各挿入時に次のような名前で新しい HDFS ファイルが作成されます。

初期: data.Parquet.gz -> data.1.Parquet.gz -> data.2.Parquet.gz など。

可能な値:

0 — INSERT クエリはファイルの最後に新しいデータを追加します。
1 — INSERT クエリは新しいファイルを作成します。

hdfs_ignore_file_doesnt_exist

タイプ: Bool

デフォルト値: 0

特定のキーを読み取る際にファイルが存在しない場合にその不在を無視します。

可能な値:

1 — SELECT は空の結果を返します。
0 — SELECT は例外をスローします。

hdfs_replication

タイプ: UInt64

デフォルト値: 0

hdfs ファイルが作成される際に指定できる実際のレプリケーション数。

hdfs_skip_empty_files

タイプ: Bool

デフォルト値: 0

HDFS エンジンテーブルで空のファイルをスキップするかどうかを有効または無効にします。

可能な値:

0 — 空のファイルがリクエストされたフォーマットと互換性がない場合、SELECT は例外をスローします。
1 — 空のファイルに対するSELECT は空の結果を返します。

hdfs_throw_on_zero_files_match

タイプ: Bool

デフォルト値: 0

グロブ展開規則に従って一致するゼロファイルがある場合にエラーをスローします。

可能な値:

1 — SELECT は例外をスローします。
0 — SELECT は空の結果を返します。

hdfs_truncate_on_insert

タイプ: Bool

デフォルト値: 0

hdfs エンジンテーブルでの挿入前に切り詰めを有効または無効にします。無効の場合、HDFS にファイルが既に存在する場合に挿入を試みると例外がスローされます。

可能な値:

0 — INSERT クエリはファイルの最後に新しいデータを追加します。
1 — INSERT クエリは既存のファイルの内容を新しいデータで置き換えます。

hedged_connection_timeout_ms

タイプ: ミリ秒

デフォルト値: 50

ヘッジ要求のためにレプリカとの接続を確立する際の接続タイムアウト。

hnsw_candidate_list_size_for_search

タイプ: UInt64

デフォルト値: 256

ベクトル類似性インデックスを探索する際の動的候補リストのサイズ、別名 'ef_search'。

hsts_max_age

タイプ: UInt64

デフォルト値: 0

HSTS の有効期限。0 は HSTS を無効にします。

http_connection_timeout

タイプ: 秒

デフォルト値: 1

HTTP 接続タイムアウト（秒単位）。

可能な値:

任意の正の整数。
0 - 無効（無限のタイムアウト）。

http_max_uri_size

タイプ: UInt64

デフォルト値: 1048576

HTTP リクエストの最大 URI 長を設定します。

可能な値:

正の整数。

http_native_compression_disable_checksumming_on_decompress

タイプ: Bool

デフォルト値: 0

クライアントからの HTTP POST データを解凍する際のチェックサム検証を有効または無効にします。 ClickHouse 独自の圧縮フォーマットにのみ使用されます（gzip や deflate には使用されません）。

詳細については、HTTP インターフェースの説明を読んでください。

可能な値:

0 — 無効。
1 — 有効。

http_receive_timeout

タイプ: 秒

デフォルト値: 30

HTTP 受信タイムアウト（秒単位）。

可能な値:

任意の正の整数。
0 - 無効（無限のタイムアウト）。

http_response_buffer_size

タイプ: UInt64

デフォルト値: 0

HTTP レスポンスをクライアントに送信する前にサーバーメモリ内でバッファリングするバイト数（http_wait_end_of_queryが有効な場合のディスクへのフラッシュも含む）。

http_retry_initial_backoff_ms

タイプ: UInt64

デフォルト値: 100

HTTP 経由で読み込む際のバックオフ初期最小マイクロ秒数。

http_retry_max_backoff_ms

タイプ: UInt64

デフォルト値: 10000

HTTP 経由で読み込む際のバックオフ最大マイクロ秒数。

http_send_timeout

タイプ: 秒

デフォルト値: 30

HTTP 送信タイムアウト（秒単位）。

可能な値:

任意の正の整数。
0 - 無効（無限のタイムアウト）。

:::note これはデフォルトプロファイルにのみ適用されます。変更を有効にするには、サーバーの再起動が必要です。 :::

http_skip_not_found_url_for_globs

タイプ: Bool

デフォルト値: 1

HTTP_NOT_FOUND エラーを伴うグローブ用の URL をスキップします。

http_wait_end_of_query

タイプ: Bool

デフォルト値: 0

サーバー側での HTTP レスポンスバッファリングを有効にします。

http_write_exception_in_output_format

タイプ: Bool

デフォルト値: 1

有効な出力を生成するために、出力形式に例外を書き込みます。JSON および XML 形式で動作します。

http_zlib_compression_level

タイプ: Int64

デフォルト値: 3

enable_http_compression = 1 の場合、HTTP リクエストへの応答でデータ圧縮のレベルを設定します。

可能な値: 1 から 9 の数値。

iceberg_engine_ignore_schema_evolution

タイプ: Bool

デフォルト値: 0

Iceberg テーブルエンジンでスキーマの進化を無視し、テーブル作成時に指定されたスキーマまたはメタデータから解析された最新スキーマを使用してすべてのデータを読み取ることを許可します。

:::note この設定を有効にすると、進化したスキーマのすべてのデータファイルが同じスキーマを使用して読み込まれるため、誤った結果につながる場合があります。 :::

idle_connection_timeout

タイプ: UInt64

デフォルト値: 3600

指定された秒数後にアイドル TCP 接続を閉じるタイムアウト。

可能な値:

正の整数（0 - すぐに閉じる、0秒後）。

ignore_cold_parts_seconds

タイプ: Int64

デフォルト値: 0

Only in ClickHouse Cloud. プリウォームされるまで（see cache_populated_by_fetch）またはこの秒数古くなるまで、SELECT クエリから新しいデータパーツを除外します。Replicated-/SharedMergeTree のみ。

ignore_data_skipping_indices

タイプ: String

デフォルト値:

クエリで使用されている場合に指定されたスキッピングインデックスを無視します。

以下の例を考えてみてください。

CREATE TABLE data
(
    key Int,
    x Int,
    y Int,
    INDEX x_idx x TYPE minmax GRANULARITY 1,
    INDEX y_idx y TYPE minmax GRANULARITY 1,
    INDEX xy_idx (x,y) TYPE minmax GRANULARITY 1
)
Engine=MergeTree()
ORDER BY key;

INSERT INTO data VALUES (1, 2, 3);

SELECT * FROM data;
SELECT * FROM data SETTINGS ignore_data_skipping_indices=''; -- クエリは CANNOT_PARSE_TEXT エラーを生成します。
SELECT * FROM data SETTINGS ignore_data_skipping_indices='x_idx'; -- Ok.
SELECT * FROM data SETTINGS ignore_data_skipping_indices='na_idx'; -- Ok。

SELECT * FROM data WHERE x = 1 AND y = 1 SETTINGS ignore_data_skipping_indices='xy_idx',force_data_skipping_indices='xy_idx' ; -- クエリは INDEX_NOT_USED エラーを生成します。なぜなら xy_idx が明示的に無視されているからです。
SELECT * FROM data WHERE x = 1 AND y = 2 SETTINGS ignore_data_skipping_indices='xy_idx';

無視せずにインデックスを使用していないクエリ:

EXPLAIN indexes = 1 SELECT * FROM data WHERE x = 1 AND y = 2;

Expression ((Projection + Before ORDER BY))
  Filter (WHERE)
    ReadFromMergeTree (default.data)
    Indexes:
      PrimaryKey
        Condition: true
        Parts: 1/1
        Granules: 1/1
      Skip
        Name: x_idx
        Description: minmax GRANULARITY 1
        Parts: 0/1
        Granules: 0/1
      Skip
        Name: y_idx
        Description: minmax GRANULARITY 1
        Parts: 0/0
        Granules: 0/0
      Skip
        Name: xy_idx
        Description: minmax GRANULARITY 1
        Parts: 0/0
        Granules: 0/0

xy_idx インデックスを無視:

EXPLAIN indexes = 1 SELECT * FROM data WHERE x = 1 AND y = 2 SETTINGS ignore_data_skipping_indices='xy_idx';

Expression ((Projection + Before ORDER BY))
  Filter (WHERE)
    ReadFromMergeTree (default.data)
    Indexes:
      PrimaryKey
        Condition: true
        Parts: 1/1
        Granules: 1/1
      Skip
        Name: x_idx
        Description: minmax GRANULARITY 1
        Parts: 0/1
        Granules: 0/1
      Skip
        Name: y_idx
        Description: minmax GRANULARITY 1
        Parts: 0/0
        Granules: 0/0

先頭の SELECT キーワードなしに単純な SELECT クエリを書くことを許可し、それにより電卓スタイルの使用が簡単になります。例: 1 + 2 が有効なクエリになります。

clickhouse-local ではデフォルトで有効であり、明示的に無効にすることができます。

implicit_transaction

タイプ: Bool

デフォルト値: 0

有効にされていて、すでにトランザクション内でない場合、クエリ全体をトランザクション内にラップします（開始 + コミットまたはロールバック）。

input_format_parallel_parsing

タイプ: Bool

デフォルト値: 1

データフォーマットの順序を保持する並列解析を有効または無効にします。サポートされているのは TSV、TSKV、CSV、および JSONEachRow 形式だけです。

可能な値:

1 — 有効。
0 — 無効。

insert_allow_materialized_columns

タイプ: Bool

デフォルト値: 0

設定が有効な場合、INSERT にマテリアライズドカラムを許可します。

insert_deduplicate

タイプ: Bool

デフォルト値: 1

INSERT のブロック重複（Replicated* テーブル用）を有効または無効にします。

可能な値:

0 — 無効。
1 — 有効。デフォルトでは、INSERTステートメントによってレプリケートされたテーブルに挿入されたブロックは重複排除されます（データレプリケーションを参照してください）。レプリケートされたテーブルでは、デフォルトで各パーティションの最近の100ブロックのみが重複排除されます（replicated_deduplication_window、replicated_deduplication_window_secondsを参照してください）。レプリケートされていないテーブルについては、non_replicated_deduplication_windowを参照してください。

insert_deduplication_token

タイプ: 文字列

デフォルト値:

この設定により、ユーザーはMergeTree/ReplicatedMergeTreeにおける独自の重複排除セマンティクスを提供できます。たとえば、各INSERTステートメントで設定のユニークな値を提供することにより、ユーザーは同じデータが重複排除されるのを回避できます。

可能な値:

任意の文字列

insert_deduplication_tokenは空でない場合にのみ重複排除に使用されます。

レプリケートされたテーブルでは、デフォルトで各パーティションの最近の挿入のうち100のみが重複排除されます（replicated_deduplication_window、replicated_deduplication_window_secondsを参照してください）。レプリケートされていないテーブルについては、non_replicated_deduplication_windowを参照してください。

:::note insert_deduplication_tokenはパーティションレベルで機能します（insert_deduplicationチェックサムと同様）。複数のパーティションは同じinsert_deduplication_tokenを持つことができます。 :::

例:

CREATE TABLE test_table
( A Int64 )
ENGINE = MergeTree
ORDER BY A
SETTINGS non_replicated_deduplication_window = 100;

INSERT INTO test_table SETTINGS insert_deduplication_token = 'test' VALUES (1);

-- 次の挿入は、insert_deduplication_tokenが異なるため、重複排除されません
INSERT INTO test_table SETTINGS insert_deduplication_token = 'test1' VALUES (1);

-- 次の挿入は、insert_deduplication_tokenが以前のものの1つと同じであるため、重複排除されます
INSERT INTO test_table SETTINGS insert_deduplication_token = 'test' VALUES (2);

SELECT * FROM test_table

┌─A─┐
│ 1 │
└───┘
┌─A─┐
│ 1 │
└───┘

insert_keeper_fault_injection_probability

タイプ: Float

デフォルト値: 0

挿入中のkeeperリクエストの失敗確率の概算。有效な値は[0.0f, 1.0f]の範囲です。

insert_keeper_fault_injection_seed

タイプ: UInt64

デフォルト値: 0

0 - ランダムシード、それ以外は設定値。

insert_keeper_max_retries

タイプ: UInt64

デフォルト値: 20

この設定は、レプリケートされたMergeTreeへの挿入中にClickHouse Keeper（またはZooKeeper）リクエストの最大再試行回数を設定します。ネットワークエラー、Keeperセッションタイムアウト、またはリクエストタイムアウトによって失敗したKeeperリクエストのみが再試行の対象とされます。

可能な値:

正の整数。
0 — 再試行は無効

クラウドのデフォルト値: 20。

Keeperリクエストの再試行は、あるタイムアウトの後に行われます。タイムアウトは次の設定によって制御されます: insert_keeper_retry_initial_backoff_ms, insert_keeper_retry_max_backoff_ms。最初の再試行はinsert_keeper_retry_initial_backoff_msのタイムアウト後に行われます。その後のタイムアウトは次のように計算されます:

timeout = min(insert_keeper_retry_max_backoff_ms, latest_timeout * 2)

例えば、insert_keeper_retry_initial_backoff_ms=100、insert_keeper_retry_max_backoff_ms=10000、およびinsert_keeper_max_retries=8の場合、タイムアウトは100, 200, 400, 800, 1600, 3200, 6400, 10000になります。

障害耐性の他に、再試行はより良いユーザーエクスペリエンスを提供する目的もあります - 例えば、Keeperが再起動中（アップグレードによる）にINSERT実行中にエラーを返さずに済むようにします。

insert_keeper_retry_initial_backoff_ms

タイプ: UInt64

デフォルト値: 100

INSERTクエリ実行中に失敗したKeeperリクエストを再試行するための初期タイムアウト（ミリ秒）。

可能な値:

正の整数。
0 — タイムアウトなし。

insert_keeper_retry_max_backoff_ms

タイプ: UInt64

デフォルト値: 10000

INSERTクエリ実行中に失敗したKeeperリクエストを再試行するための最大タイムアウト（ミリ秒）。

可能な値:

正の整数。
0 — 最大タイムアウトは無制限。

insert_null_as_default

タイプ: Bool

デフォルト値: 1

NULLの代わりに、デフォルト値を挿入するかどうかを有効または無効にします。NULLでないデータ型のカラムに対しては、カラムタイプがNULLでない場合、この設定が無効のときにNULLを挿入すると例外が発生します。カラムタイプがNULL可能な場合、NULL値はこの設定に関係なくそのまま挿入されます。

この設定はINSERT ... SELECTクエリに適用されます。SELECTサブクエリはUNION ALL句で連結可能であることに注意してください。

可能な値:

0 — NULLをNULLでないカラムに挿入すると例外が発生します。
1 — NULLの代わりにデフォルトカラム値が挿入されます。

insert_quorum

タイプ: UInt64Auto

デフォルト値: 0

:::note この設定はSharedMergeTreeには適用されません。詳しくはSharedMergeTreeの整合性を参照してください。 :::

クォーラム書き込みを有効にします。

insert_quorum < 2の場合、クォーラム書き込みは無効です。
insert_quorum >= 2の場合、クォーラム書き込みは有効です。
insert_quorum = 'auto'の場合、過半数の数（number_of_replicas / 2 + 1）をクォーラム数として使用します。

クォーラム書き込み

INSERTは、ClickHouseがinsert_quorum_timeoutの間にinsert_quorumのレプリカにデータを書き込むことに成功した場合にのみ成功します。何らかの理由で成功した書き込みのレプリカ数がinsert_quorumに達しない場合、書き込みは失敗と見なされ、ClickHouseはすでに書き込まれたレプリカから挿入されたブロックを削除します。

insert_quorum_parallelが無効の場合、クォーラム内のすべてのレプリカは一貫性があります。つまり、すべての以前のINSERTクエリのデータを含んでいます（INSERTシーケンスは線形化されます）。insert_quorumおよびinsert_quorum_parallelを使用して書き込まれたデータを読み取る際には、select_sequential_consistencyを使用してSELECTクエリの順次整合性を有効にすることができます。

ClickHouseは次の場合に例外を生成します:

クエリの時点での利用可能なレプリカの数がinsert_quorum未満の場合。
insert_quorum_parallelが無効であり、前のブロックがinsert_quorumのレプリカにまだ挿入されていないときにデータを書き込もうとした場合。この状況は、ユーザーが以前のinsert_quorumのINSERTクエリが完了する前に同じテーブルに別のINSERTクエリを実行しようとした場合に発生することがあります。

その他の情報は以下を参照してください：

insert_quorum_timeout
insert_quorum_parallel
select_sequential_consistency

insert_quorum_parallel

タイプ: Bool

デフォルト値: 1

:::note この設定はSharedMergeTreeには適用されません。詳しくはSharedMergeTreeの整合性を参照してください。 :::

クォーラムINSERTクエリに対して並列性を有効または無効にします。これが有効な場合、前のクエリがまだ終了していない間に追加のINSERTクエリを送信できます。無効にした場合、同じテーブルに対する追加の書き込みは拒否されます。

可能な値:

0 — 無効。
1 — 有効。

その他の情報は以下を参照してください：

insert_quorum
insert_quorum_timeout
select_sequential_consistency

insert_quorum_timeout

タイプ: ミリ秒

デフォルト値: 600000

クォーラムへの書き込みタイムアウト（ミリ秒）。タイムアウトが経過し、まだ書き込みが行われていない場合、ClickHouseは例外を生成し、クライアントは同じブロックを同じまたは他のレプリカに書き込むためにクエリを再試行する必要があります。

その他の情報は以下を参照してください：

insert_quorum
insert_quorum_parallel
select_sequential_consistency

insert_shard_id

タイプ: UInt64

デフォルト値: 0

0でない場合、データが同期的に挿入される分散テーブルのシャードを指定します。

insert_shard_idの値が無効な場合、サーバーは例外を投げます。

requested_clusterのシャード数を取得するには、サーバーの設定を確認するか、次のクエリを使用できます:

SELECT uniq(shard_num) FROM system.clusters WHERE cluster = 'requested_cluster';

可能な値:

0 — 無効。
対応する分散テーブルの1からshards_numの任意の数。

例

クエリ:

CREATE TABLE x AS system.numbers ENGINE = MergeTree ORDER BY number;
CREATE TABLE x_dist AS x ENGINE = Distributed('test_cluster_two_shards_localhost', currentDatabase(), x);
INSERT INTO x_dist SELECT * FROM numbers(5) SETTINGS insert_shard_id = 1;
SELECT * FROM x_dist ORDER BY number ASC;

結果:

┌─number─┐
│      0 │
│      0 │
│      1 │
│      1 │
│      2 │
│      2 │
│      3 │
│      3 │
│      4 │
│      4 │
└────────┘

interactive_delay

タイプ: UInt64

デフォルト値: 100000

リクエストの実行がキャンセルされたかどうかをチェックし、進捗を送信するためのマイクロ秒単位の間隔。

intersect_default_mode

タイプ: SetOperationMode

デフォルト値: ALL

INTERSECTクエリのデフォルトモードを設定します。可能な値: 空の文字列、'ALL'、'DISTINCT'。空の場合、モードなしでのクエリは例外をスローします。

join_algorithm

タイプ: JoinAlgorithm

デフォルト値: default

使用されるJOINアルゴリズムを指定します。

複数のアルゴリズムを指定でき、適切なものが特定のクエリの種類/厳密性およびテーブルエンジンに基づいて選択されます。

可能な値:

default

これは、可能であればhashまたはdirectの同等です（direct,hashと同じ）。

grace_hash

Grace hash joinが使用されます。Grace hashは、メモリの使用を制限しながらパフォーマンスの良い複雑な結合を提供するアルゴリズムオプションを提供します。

grace joinの最初のフェーズでは、右側のテーブルを読み取り、それをキー列のハッシュ値に基づいてNバケットに分割します（最初はNはgrace_hash_join_initial_bucketsです）。各バケットが独立して処理できることを保証する方法でこれが行われます。最初のバケットの行はメモリ内ハッシュテーブルに追加され、他の行はディスクに保存されます。ハッシュテーブルがメモリ制限を超えた場合（例: max_bytes_in_joinで設定されたもの）、バケットの数が増加し、各行の割り当てバケットも増えます。現在のバケットに属さない行はフラッシュされ、再割り当てされます。

INNER/LEFT/RIGHT/FULL ALL/ANY JOINをサポートします。
hash

Hash join algorithmが使用されます。すべての種類および厳密性の組み合わせと、JOIN ONセクションでORで結合された複数の結合キーをサポートする最も一般的な実装です。
parallel_hash

hashの変種で、データをバケットに分割し、プロセスを加速するために同時に複数のハッシュテーブルを構築します。

hashアルゴリズムを使用する際、右側のJOINの部分がRAMにアップロードされます。
partial_merge

sort-merge algorithmの変種で、右側のテーブルのみが完全にソートされています。

RIGHT JOINおよびFULL JOINは、厳密さのすべてがALLである場合にのみサポートされます（SEMI、ANTI、ANY、およびASOFはサポートされていません）。

partial_mergeアルゴリズムを使用する際、ClickHouseはデータをソートし、ディスクにダンプします。ClickHouseのpartial_mergeアルゴリズムは、古典的な実現とは少し異なります。最初に、ClickHouseは結合キーでブロックごとに右のテーブルをソートし、ソートされたブロックに対して最小-最大インデックスを作成します。次に、左側のテーブルの部分をjoin keyでソートし、それを右のテーブルに対して結合します。最小-最大インデックスも必要ない右テーブルのブロックをスキップするために使用されます。
direct

このアルゴリズムは、右のテーブルがキー-バリューリクエストをサポートするストレージのために適用できます。

directアルゴリズムは、左のテーブルの行をキーとして使用して右のテーブルでルックアップを行います。これは、DictionaryやEmbeddedRocksDBなどの特別なストレージによってのみサポートされており、LEFT及びINNERJOINだけがサポートされています。
auto

autoに設定されている場合、最初にhash結合が試みられ、メモリ制限が違反された場合は、動的に他のアルゴリズムに切り替えられます。
full_sorting_merge

Sort-merge algorithmを完全にソートされた結合テーブルを結合する前に使用します。
prefer_partial_merge

ClickHouseは可能であれば常にpartial_merge結合を使用しようとし、そうでなければhashを使用します。非推奨、partial_merge,hashと同じです。

join_any_take_last_row

タイプ: Bool

デフォルト値: 0

ANYの厳密さを使用した結合操作の動作を変更します。

:::note この設定は、JoinエンジンのテーブルのみのJOIN操作に適用されます。 :::

可能な値:

0 — 右のテーブルに一致する行が複数ある場合、最初に見つかった行のみが結合されます。
1 — 右のテーブルに一致する行が複数ある場合、最後に見つかった行のみが結合されます。

その他の情報は以下を参照してください：

join_default_strictness

タイプ: JoinStrictness

デフォルト値: ALL

JOIN句のデフォルトの厳密さを設定します。

可能な値:

ALL — 右のテーブルに一致する行が複数ある場合、ClickHouseは一致する行からデカルト積を生成します。これが標準SQLからの通常のJOINの動作です。
ANY — 右のテーブルに一致する行が複数ある場合、最初に見つかった行のみが結合されます。右のテーブルに一致する行が1つしかない場合、ANYとALLの結果は同じです。
ASOF — 不確実な一致を持つシーケンスの結合に使用されます。
空の文字列 — クエリにALLまたはANYが指定されていない場合、ClickHouseは例外をスローします。

join_on_disk_max_files_to_merge

タイプ: UInt64

デフォルト値: 64

ディスク上で実行されるMergeJoin操作の並列ソートのために許可されるファイルの数を制限します。

設定値が大きいほど、使用されるRAMが多く、ディスクI/Oが少なくなります。

可能な値:

2から始まる正の整数。

join_output_by_rowlist_perkey_rows_threshold

タイプ: UInt64

デフォルト値: 5

ハッシュ結合において、行リストで出力するかどうかを決定するための右のテーブルのキーごとの平均行数の下限。

join_overflow_mode

タイプ: OverflowMode

デフォルト値: throw

制限を超えた場合に何をするかを指定します。

join_to_sort_maximum_table_rows

タイプ: UInt64

デフォルト値: 10000

左または内部結合において、右のテーブルをキーによって再整理するかどうかを決定するための右のテーブルの最大行数。

join_to_sort_minimum_perkey_rows

タイプ: UInt64

デフォルト値: 40

左または内部結合において、右のテーブルをキーによって再整理するかどうかを決定するための右のテーブルのキーごとの平均行数の下限。この設定は、スパーステーブルキーに対して最適化が適用されないようにします。

join_use_nulls

タイプ: Bool

デフォルト値: 0

JOINの動作タイプを設定します。テーブルをマージする際に空のセルが出現することがあります。ClickHouseは、この設定に基づいてそれらを異なる方法で埋めます。

可能な値:

0 — 空のセルは対応するフィールドタイプのデフォルト値で埋まります。
1 — JOINは標準SQLと同様の動作をします。対応するフィールドの型はNullableに変換され、空のセルはNULLで埋まります。

joined_subquery_requires_alias

タイプ: Bool

デフォルト値: 1

正しい名前の資格のために、結合サブクエリとテーブル関数に別名を付けることを強制します。

kafka_disable_num_consumers_limit

タイプ: Bool

デフォルト値: 0

利用可能なCPUコアの数に依存するkafka_num_consumersの制限を無効にします。

kafka_max_wait_ms

タイプ: ミリ秒

デフォルト値: 5000

再試行前にKafkaからメッセージを読み取るための待機時間（ミリ秒）。

可能な値:

正の整数。
0 — 無限のタイムアウト。

その他の情報は以下を参照してください：

Apache Kafka

可能な値:

0 - 削除は非同期に実行されます。
1 - クエリは現在のサーバーで論理削除が完了するのを待機します。
2 - クエリはすべてのレプリカ（存在する場合）で論理削除が完了するのを待機します。

その他の情報

limit

タイプ: UInt64

デフォルト値: 0

クエリ結果から取得する最大行数を設定します。これは、LIMIT句で設定された値を調整し、クエリに指定された制限がこの設定で設定された制限を超えることがないようにします。

可能な値:

0 — 行数に制限はありません。
正の整数。

live_view_heartbeat_interval

タイプ: 秒

デフォルト値: 15

ライブクエリが生きていることを示すハートビート間隔（秒）。

load_balancing

タイプ: LoadBalancing

デフォルト値: random

分散クエリ処理に使用されるレプリカ選択のアルゴリズムを指定します。

ClickHouseは、次のようなレプリカの選択アルゴリズムをサポートしています:

Random（デフォルト）
Nearest hostname
Hostname levenshtein distance
In order
First or random
Round robin

その他の情報は以下を参照してください：

distributed_replica_max_ignored_errors

Random (デフォルト)

load_balancing = random

各レプリカのエラーの数がカウントされます。クエリは、最も少ないエラーを持つレプリカに送信され、同じエラー数のレプリカが複数ある場合は、そのうちのどれかに送信されます。欠点: サーバーの近接性は考慮されず、レプリカが異なるデータを持っている場合、異なるデータが返される可能性があります。

Nearest Hostname

load_balancing = nearest_hostname

各レプリカのエラーの数がカウントされます。5分ごとに、エラーの数は2で統合的に割り算されます。これにより、最近の時間に基づいてエラーの数が指数的にスムージングされて計算されます。エラー数が最も少ないレプリカが1つある場合（すなわち、他のレプリカでは最近エラーが発生している）、クエリはそのレプリカに送信されます。同じ最小エラー数のレプリカが複数ある場合は、設定ファイルのサーバーのホスト名に最も類似したホスト名のレプリカにクエリが送信されます（同じ位置に異なる文字数による）。

たとえば、example01-01-1とexample01-01-2は1箇所で異なり、example01-01-1とexample01-02-2は2箇所で異なります。この方法は単純に見えるかもしれませんが、ネットワークトポロジーに関する外部データを必要とせず、IPアドレスを比較することも難しいIPv6アドレスに対しても対処します。

したがって、等価なレプリカが存在する場合、名前によって最も近いものが優先されます。さらに、同じサーバーにクエリを送信する場合、障害がない場合、分散クエリも同じサーバーに送信されると考えられます。そのため、レプリカに異なるデータが格納されていても、クエリはほとんど同じ結果を返します。

Hostname levenshtein distance

load_balancing = hostname_levenshtein_distance

nearest_hostnameと同様ですが、ホスト名をlevenshtein distanceの方式で比較します。例えば:

example-clickhouse-0-0 ample-clickhouse-0-0
1

example-clickhouse-0-0 example-clickhouse-1-10
2

example-clickhouse-0-0 example-clickhouse-12-0
3

In Order

load_balancing = in_order

同じエラー数のレプリカには、設定ファイルに記載された順序のままアクセスされます。この方法は、どのレプリカが優先されるかが明確にわかっているときに適切です。

First or Random

load_balancing = first_or_random

このアルゴリズムは、設定された最初のレプリカを選択します。最初のレプリカが利用できない場合はランダムなレプリカを選択します。これは、クロスレプリケーショントポロジーのセットアップで効果的ですが、他の構成では役に立ちません。

first_or_randomアルゴリズムは、in_orderアルゴリズムの問題を解決します。in_orderの場合、あるレプリカがダウンすると次のレプリカに二重負荷がかかり、残りのレプリカは通常のトラフィックの量を処理します。first_or_randomアルゴリズムを使用する場合、まだ利用可能なレプリカの間で負荷が均等に分散されます。

first_or_randomアルゴリズムを使用して、最初のレプリカを明示的に定義することもできます。この設定を使用すると、レプリカ間でクエリのワークロードを再バランスするより多くの制御が可能になります。

Round Robin

load_balancing = round_robin

このアルゴリズムは、同じエラー数のレプリカに対してラウンドロビンポリシーを使用します（round_robinポリシーのクエリのみがカウントされます）。

load_balancing_first_offset

タイプ: UInt64

デフォルト値: 0

FIRST_OR_RANDOMロードバランシング戦略が使用されているときに、優先的にクエリを送信するレプリカを指定します。

load_marks_asynchronously

タイプ: Bool

デフォルト値: 0

MergeTreeマークを非同期にロードします。

local_filesystem_read_method

タイプ: 文字列

デフォルト値: pread_threadpool

ローカルファイルシステムからデータを読み取るためのメソッド。選択肢: read, pread, mmap, io_uring, pread_threadpool。'io_uring'メソッドはエクスペリメンタルで、Log、TinyLog、StripeLog、File、Set、および同時読み書きがある場合は他のテーブルでは機能しません。

local_filesystem_read_prefetch

タイプ: Bool

デフォルト値: 0

ローカルファイルシステムからデータを読み取る際にプリフェッチを使用するかどうか。

lock_acquire_timeout

タイプ: 秒

デフォルト値: 120

ロックリクエストが失敗するまでに待機する秒数を定義します。

ロックタイムアウトは、テーブルでの読み取り/書き込み操作を実行中にデッドロックから保護するために使用されます。タイムアウトが経過するとロックリクエストが失敗し、ClickHouseサーバーは「ロック試行がタイムアウトしました！デッドロックの回避が可能です。クライアントは再試行する必要があります。」という例外を投げます。エラーコードはDEADLOCK_AVOIDEDです。

可能な値:

正の整数（秒単位）。
0 — ロックタイムアウトなし。

log_comment

タイプ: 文字列

デフォルト値:

system.query_logテーブルのlog_commentフィールドの値と、サーバーログのコメントテキストを指定します。

これにより、サーバーログの可読性を向上させることができます。さらに、clickhouse-testを実行した後に、テストに関連するクエリをsystem.query_logから選択するのにも役立ちます。

可能な値:

max_query_sizeを超えない任意の文字列。max_query_sizeを超えると、サーバーは例外をスローします。

例

クエリ:

SET log_comment = 'log_comment test', log_queries = 1;
SELECT 1;
SYSTEM FLUSH LOGS;
SELECT type, query FROM system.query_log WHERE log_comment = 'log_comment test' AND event_date >= yesterday() ORDER BY event_time DESC LIMIT 2;

結果:

┌─type────────┬─query─────┐
│ QueryStart  │ SELECT 1; │
│ QueryFinish │ SELECT 1; │
└─────────────┴───────────┘

log_formatted_queries

タイプ: Bool

デフォルト値: 0

system.query_logシステムテーブルにフォーマットされたクエリをログすることを許可します（system.query_logのformatted_query列にデータを埋め込みます）。

可能な値:

0 — フォーマットされたクエリはシステムテーブルにログされません。
1 — フォーマットされたクエリはシステムテーブルにログされます。

log_processors_profiles

タイプ: Bool

デフォルト値: 1

実行中にプロセッサが費やした時間をsystem.processors_profile_logテーブルに書き込みます。

その他の情報は以下を参照してください：

log_profile_events

タイプ: Bool

デフォルト値: 1

クエリパフォーマンス統計をquery_log、query_thread_log、およびquery_views_logにログします。

log_queries

タイプ: Bool

デフォルト値: 1

クエリログを設定します。

この設定でClickHouseに送信されたクエリは、query_logサーバー設定パラメータのルールに従ってログされます。

例:

log_queries=1

log_queries_cut_to_length

タイプ: UInt64

デフォルト値: 100000

クエリの長さが指定された閾値（バイト単位）を超える場合、クエリはクエリログに書き込む際にカットされます。また、通常のテキストログに印刷されるクエリの長さも制限されます。

log_queries_min_query_duration_ms

タイプ: ミリ秒

デフォルト値: 0

無効にした場合（0以外）、この設定の値よりも早く実行されたクエリはログに記録されません（これはMySQLのスロークエリログのlong_query_timeのように考えられます）。基本的に、次のテーブルには表示されません。

system.query_log
system.query_thread_log

次のタイプのクエリのみがログに記載されます。

QUERY_FINISH
EXCEPTION_WHILE_PROCESSING
タイプ: ミリ秒
デフォルト値: 0（すべてのクエリ）

log_queries_min_type

タイプ: LogQueriesType

デフォルト値: QUERY_START

query_logに記録する最小タイプです。

可能な値:

QUERY_START（=1）
QUERY_FINISH（=2）
EXCEPTION_BEFORE_START（=3）
EXCEPTION_WHILE_PROCESSING（=4）

これを使用して、query_logにどのエンティティをログに記録するかを制限できます。たとえば、エラーのみに関心がある場合は、EXCEPTION_WHILE_PROCESSINGを使用できます:

log_queries_min_type='EXCEPTION_WHILE_PROCESSING'

log_queries_probability

タイプ: Float

デフォルト値: 1

ユーザーがquery_log、query_thread_log、およびquery_views_logシステムテーブルに、指定された確率でランダムに選択されたクエリのサンプルのみをログに記録できるようにします。これにより、1秒あたり大量のクエリが発生する際の負荷を削減できます。

可能な値:

0 — クエリはシステムテーブルにログされません。
正の浮動小数点数で範囲は [0..1]。例えば、設定値が 0.5 の場合、クエリの約半分がシステムテーブルに記録されます。
1 — すべてのクエリがシステムテーブルに記録されます。

log_query_settings

タイプ: Bool

デフォルト値: 1

クエリログと OpenTelemetry span ログにクエリ設定を記録します。

log_query_threads

タイプ: Bool

デフォルト値: 0

クエリスレッドのロギングを設定します。

クエリスレッドは system.query_thread_log テーブルにログとして記録されます。この設定は、log_queries が true の場合のみ効果があります。この設定で ClickHouse によって実行されるクエリのスレッドは、query_thread_log サーバー設定パラメーターのルールに従って記録されます。

可能な値:

0 — 無効。
1 — 有効。

例

log_query_threads=1

log_query_views

タイプ: Bool

デフォルト値: 1

クエリビューのロギングを設定します。

この設定が有効な状態で ClickHouse によって実行されるクエリに関連するビュー（物化ビューまたはライブビュー）があれば、それらは query_views_log サーバー設定パラメーターに記録されます。

例:

log_query_views=1

low_cardinality_allow_in_native_format

タイプ: Bool

デフォルト値: 1

LowCardinality データ型を Native 形式で使用することを許可または制限します。

LowCardinality の使用が制限されている場合、ClickHouse サーバーは SELECT クエリのために LowCardinality カラムを通常のカラムに変換し、INSERT クエリのために通常のカラムを LowCardinality カラムに変換します。

この設定は、LowCardinality データ型をサポートしないサードパーティクライアント向けに主に必要です。

可能な値:

1 — LowCardinality の使用は制限されません。
0 — LowCardinality の使用は制限されます。

low_cardinality_max_dictionary_size

タイプ: UInt64

デフォルト値: 8192

LowCardinality データ型のためにストレージファイルシステムに書き込むことができる共有グローバルDictionaryの最大サイズ（行数）を設定します。この設定は、無制限のDictionary成長によるRAMの問題を防ぎます。最大Dictionaryサイズの制限によりエンコードできないすべてのデータは、ClickHouse が通常の方法で書き込みます。

可能な値:

任意の正の整数。

low_cardinality_use_single_dictionary_for_part

タイプ: Bool

デフォルト値: 0

データパートのために単一Dictionaryの使用をオンまたはオフにします。

デフォルトでは、ClickHouse サーバーはDictionaryのサイズを監視し、Dictionaryがオーバーフローした場合に次のDictionaryの書き込みを開始します。複数のDictionaryの作成を禁止するには low_cardinality_use_single_dictionary_for_part = 1 を設定します。

可能な値:

1 — データパートのための複数のDictionaryの作成が禁止されます。
0 — データパートのための複数のDictionaryの作成は禁止されません。

max_block_size

タイプ: UInt64

デフォルト値: 65409

タイプ: UInt64

デフォルト値: 1048576

テーブルに書き込むために圧縮する前の未圧縮データのブロックの最大サイズ。デフォルトは1,048,576（1 MiB）。一般に小さいブロックサイズを指定すると圧縮率がわずかに低下し、キャッシュの局所性により圧縮および解凍速度がわずかに向上し、メモリ消費が減少します。

:::note これは専門的な設定であり、ClickHouse を始めたばかりの場合は変更しないでください。 :::

圧縮用のブロック（バイトのチャンクからなるメモリの断片）とクエリ処理用のブロック（テーブルからの行のセット）を混同しないでください。

max_concurrent_queries_for_all_users

タイプ: UInt64

デフォルト値: 0

この設定の値が同時に処理されているクエリの現在の数以下の場合、例外をスローします。

例: max_concurrent_queries_for_all_users を99に設定し、データベース管理者は自身が100に設定することで、サーバーがオーバーロードされている場合でも調査のためのクエリを実行できます。

1つのクエリまたはユーザーの設定を変更しても、他のクエリには影響しません。

可能な値:

正の整数。
0 — 制限なし。

例

<max_concurrent_queries_for_all_users>99</max_concurrent_queries_for_all_users>

関連情報

max_concurrent_queries

max_concurrent_queries_for_user

タイプ: UInt64

デフォルト値: 0

ユーザーごとに同時に処理されるクエリの最大数。

可能な値:

正の整数。
0 — 制限なし。

例

<max_concurrent_queries_for_user>5</max_concurrent_queries_for_user>

max_distributed_connections

タイプ: UInt64

デフォルト値: 1024

単一の分散テーブルに対して単一のクエリのためのリモートサーバーとの同時接続の最大数。クラスター内のサーバーの数以上の値を設定することを推奨します。

次のパラメータは、分散テーブルを作成する際とサーバーを起動する際のみ使用されるため、実行時に変更する理由はありません。

max_distributed_depth

タイプ: UInt64

デフォルト値: 5

Distributed テーブルの再帰クエリの最大深さを制限します。

値が超えた場合、サーバーは例外をスローします。

可能な値:

正の整数。
0 — 深さ制限なし。

可能な値:

正の整数。
0 または 1 — 無効。 SELECT クエリは単一スレッドで実行されます。

max_http_get_redirects

タイプ: UInt64

デフォルト値: 0

許可される最大数のHTTP GETリダイレクトホップ。悪意のあるサーバーがリクエストを予期しないサービスにリダイレクトするのを防ぐために、追加のセキュリティ対策が講じられています。\n\nこれは、外部サーバーが他のアドレスにリダイレクトする場合ですが、そのアドレスが企業のインフラに内部的に見える場合に該当します。内部サーバーにHTTPリクエストを送信すると、認証をバイパスして内部ネットワークから内部APIを要求したり、Redis や Memcached などの他のサービスをクエリしたりすることができます。内部のインフラストラクチャ（ローカルホストで動作しているものを含む）を持っていない場合や、サーバーを信頼する場合は、リダイレクトを許可するのは安全です。ただし、URLがHTTPを使用している場合は、リモートサーバーだけでなく、ISPや中間のすべてのネットワークも信頼しなければなりません。

max_hyperscan_regexp_length

タイプ: UInt64

デフォルト値: 0

hyperscan マルチマッチ関数での各正規表現の最大長を定義します。

可能な値:

正の整数。
0 — 長さに制限なし。

例

クエリ:

SELECT multiMatchAny('abcd', ['ab','bcd','c','d']) SETTINGS max_hyperscan_regexp_length = 3;

結果:

┌─multiMatchAny('abcd', ['ab', 'bcd', 'c', 'd'])─┐
│                                              1 │
└────────────────────────────────────────────────┘

クエリ:

SELECT multiMatchAny('abcd', ['ab','bcd','c','d']) SETTINGS max_hyperscan_regexp_length = 2;

結果:

Exception: Regexp length too large.

関連情報

max_hyperscan_regexp_total_length

max_hyperscan_regexp_total_length

タイプ: UInt64

デフォルト値: 0

hyperscan マルチマッチ関数内のすべての正規表現の合計最大長を設定します。

可能な値:

正の整数。
0 — 長さに制限なし。

例

クエリ:

SELECT multiMatchAny('abcd', ['a','b','c','d']) SETTINGS max_hyperscan_regexp_total_length = 5;

結果:

┌─multiMatchAny('abcd', ['a', 'b', 'c', 'd'])─┐
│                                           1 │
└─────────────────────────────────────────────┘

クエリ:

SELECT multiMatchAny('abcd', ['ab','bc','c','d']) SETTINGS max_hyperscan_regexp_total_length = 5;

結果:

Exception: Total regexp lengths too large.

関連情報

max_hyperscan_regexp_length

max_insert_block_size

タイプ: UInt64

デフォルト値: 1048449

テーブルに挿入するために形成されるブロックのサイズ（行数）です。この設定は、サーバーがブロックを形成する場合にのみ適用されます。例えば、HTTP インターフェース経由のINSERTの場合、サーバーはデータ形式を解析し、指定されたサイズのブロックを形成します。しかし、clickhouse-clientを使用する場合、クライアントはデータを独自に解析し、サーバーでの max_insert_block_size 設定は挿入されるブロックのサイズに影響を与えません。この設定は、INSERT SELECT を使用する場合には目的がありません。SELECT の後に形成される同じブロックを使用してデータが挿入されるためです。

デフォルト値は max_block_size よりわずかに大きくなっています。これは、特定のテーブルエンジン（*MergeTree）がディスクに挿入された各ブロックのデータパートを形成するため、かなり大きなエンティティになるためです。同様に、*MergeTree テーブルは挿入中にデータをソートし、十分に大きなブロックサイズによってメモリ内でより多くのデータをソートできるようにします。

max_insert_delayed_streams_for_parallel_write

タイプ: UInt64

デフォルト値: 0

最終パートフラッシュを遅らせるための最大ストリーム（カラム）の数。デフォルトは自動（基盤となるストレージが並列書き込みをサポートしている場合は1000、それ以外は無効）。

max_insert_threads

タイプ: UInt64

デフォルト値: 0

INSERT SELECT クエリを実行するための最大スレッド数。

可能な値:

0（または 1） — INSERT SELECT は並列実行されません。
正の整数。1より大きい。

デフォルト値: 0

ネットワーク越しのデータ交換の速度を制限します（バイト毎秒）。この設定は、すべてのクエリに適用されます。

可能な値:

正の整数。
0 — 帯域幅制御が無効です。

max_network_bandwidth_for_all_users

タイプ: UInt64

デフォルト値: 0

ネットワーク越しのデータ交換の速度を制限します（バイト毎秒）。この設定は、サーバー上のすべての同時実行クエリに適用されます。

可能な値:

正の整数。
0 — データ速度制御が無効です。

max_network_bandwidth_for_user

タイプ: UInt64

デフォルト値: 0

ユーザーによるネットワーク越しのデータ交換の速度を制限します（バイト毎秒）。この設定は、単一のユーザーが実行するすべての同時実行クエリに適用されます。

可能な値:

正の整数。
0 — データ速度制御が無効です。

max_network_bytes

タイプ: UInt64

デフォルト値: 0

クエリを実行する際に、ネットワーク越しに受信または送信されるデータ量（バイト単位）を制限します。この設定は、各個別のクエリに適用されます。

可能な値:

正の整数。
0 — データ量制御が無効です。

max_number_of_partitions_for_independent_aggregation

タイプ: UInt64

デフォルト値: 128

最適化を適用するためのテーブル内の最大パーティション数。

max_parallel_replicas

タイプ: NonZeroUInt64

デフォルト値: 1

クエリを実行する際の各シャードに対する最大のレプリカ数。

可能な値:

正の整数。

追加情報

このオプションは使用される設定に応じて異なる結果を生じます。

:::note この設定は、結合またはサブクエリが関与している場合や、すべてのテーブルが特定の要件を満たしていない場合に不正確な結果を生じます。詳細については、Distributed Subqueries and max_parallel_replicas を参照してください。 :::

`SAMPLE` キーを使用した並列処理

クエリは、複数のサーバーで同時に実行される場合、より速く処理されることがあります。しかし、次のような場合にはクエリのパフォーマンスが低下する可能性があります。

サンプリングキーの位置がパーティショニングキー内にあり、効率的な範囲スキャンができない。
テーブルにサンプリングキーを追加することで、他のカラムによるフィルタリングの効率が低下する。
サンプリングキーが計算コストの高い式である。
クラスタのレイテンシ分布にロングテールがあるため、サーバーを増やすと全体のレイテンシが増加する。

parallel_replicas_custom_key を使用した並列処理

タイプ: UInt64

デフォルト値: 1000

1つのクエリで移動できるパーツの数を制限します。ゼロは無制限を意味します。

max_query_size

タイプ: UInt64

可能な値:

正の整数。
0 — レプリカの遅延はチェックされません。

デフォルト値: 0

結合テーブルをお互いの行セットでフィルタリングするための最大セットサイズ。

可能な値:

0 — 無効。
任意の正の整数。

max_table_size_to_drop

タイプ: UInt64

デフォルト値: 50000000000

デフォルト値: 4194304

メモリプロファイラのステップを設定します。クエリのメモリ使用量が次のステップのバイト数よりも大きくなると、メモリプロファイラは割り当てスタックトレースを収集し、それをtrace_logに書き込みます。

可能な値:

正の整数（バイト単位）。
メモリプロファイラをオフにするには0を設定します。

memory_tracker_fault_probability

タイプ: Float

デフォルト値: 0

exception safetyのテスト - 指定された確率でメモリを割り当てるたびに例外を投げます。

memory_usage_overcommit_max_wait_microseconds

タイプ: UInt64

デフォルト値: 5000000

ユーザーレベルでのメモリオーバーコミットの場合、スレッドがメモリの解放を待つ最大時間。タイムアウトに達し、メモリが解放されない場合、例外が投げられます。メモリオーバーコミットについての詳細をお読みください。

merge_tree_coarse_index_granularity

タイプ: UInt64

デフォルト値: 8

データを検索する際、ClickHouseはインデックスファイルのデータマークを確認します。必要なキーが特定の範囲に存在する場合、ClickHouseはこの範囲をmerge_tree_coarse_index_granularityのサブ範囲に分割し、再帰的にそこに必要なキーを探索します。

可能な値:

任意の正の偶数整数。

merge_tree_compact_parts_min_granules_to_multibuffer_read

タイプ: UInt64

デフォルト値: 16

ClickHouse Cloud専用。MergeTreeテーブルのコンパクト部のストライプ内のグラニュール数で、マルチバッファリーダーを使用して並行読み込みとプリフェッチをサポートします。リモートfsから読み込む際にマルチバッファリーダーを使用すると、読み取り要求の数が増加します。

merge_tree_determine_task_size_by_prewhere_columns

タイプ: Bool

デフォルト値: 1

読み取りタスクのサイズを決定するためにのみ、前に指定されたカラムのサイズを使用するかどうか。

merge_tree_max_bytes_to_use_cache

タイプ: UInt64

デフォルト値: 2013265920

ClickHouseが1つのクエリでmerge_tree_max_bytes_to_use_cacheバイトを超えて読み込む必要がある場合、未圧縮ブロックのキャッシュは使用されません。

未圧縮ブロックのキャッシュは、クエリのために抽出されたデータを格納します。ClickHouseは、このキャッシュを使用して繰り返される小さなクエリへの応答を迅速化します。この設定は、大量のデータを読み込むクエリによってキャッシュが破壊されるのを防ぎます。uncompressed_cache_sizeサーバー設定は、未圧縮ブロックのキャッシュのサイズを定義します。

可能な値:

任意の正の整数。

merge_tree_max_rows_to_use_cache

タイプ: UInt64

デフォルト値: 1048576

ClickHouseが1つのクエリでmerge_tree_max_rows_to_use_cache行を超えて読み込む必要がある場合、未圧縮ブロックのキャッシュは使用されません。

可能な値:

任意の正の整数。

merge_tree_min_bytes_for_concurrent_read

タイプ: UInt64

デフォルト値: 251658240

MergeTreeエンジンテーブルの1ファイルから読み取るバイト数がmerge_tree_min_bytes_for_concurrent_readを超える場合、ClickHouseはこのファイルから複数のスレッドでの並行読み取りを試みます。

可能な値:

正の整数。

merge_tree_min_bytes_for_concurrent_read_for_remote_filesystem

タイプ: UInt64

デフォルト値: 0

リモートファイルシステムからの読み取り時に、MergeTreeエンジンが読み取りを並列化できるようにする前に、1ファイルから読み取るバイト数の最小値です。この設定の使用は推奨されません。

可能な値:

正の整数。

merge_tree_min_bytes_for_seek

タイプ: UInt64

デフォルト値: 0

1ファイル内の2つのデータブロックの間の距離がmerge_tree_min_bytes_for_seekバイト未満である場合、ClickHouseは両方のブロックを含むファイルの範囲を sequentiallyに読み込み、余分なシークを回避します。

可能な値:

任意の正の整数。

merge_tree_min_bytes_per_task_for_remote_reading

タイプ: UInt64

デフォルト値: 2097152

タスクごとに読み取るバイト数の最小値。

merge_tree_min_read_task_size

タイプ: UInt64

デフォルト値: 8

タスクサイズの絶対下限（グラニュール数が少なく、利用可能なスレッド数が多くても小さなタスクを割り当てません）。

merge_tree_min_rows_for_concurrent_read

タイプ: UInt64

デフォルト値: 163840

1ファイルから読み取る行数がmerge_tree_min_rows_for_concurrent_readを超える場合、ClickHouseはこのファイルから複数のスレッドでの並行読み取りを試みます。

可能な値:

正の整数。

merge_tree_min_rows_for_concurrent_read_for_remote_filesystem

タイプ: UInt64

デフォルト値: 0

リモートファイルシステムからの読み取り時に、MergeTreeエンジンが読み取りを並列化できるようにする前に、1ファイルから読み取る行数の最小値です。この設定の使用は推奨されません。

可能な値:

正の整数。

merge_tree_min_rows_for_seek

タイプ: UInt64

デフォルト値: 0

1ファイル内の2つのデータブロックの間の距離がmerge_tree_min_rows_for_seek行未満である場合、ClickHouseはファイルをシークせず、データを逐次読み込みます。

可能な値:

任意の正の整数。

merge_tree_read_split_ranges_into_intersecting_and_non_intersecting_injection_probability

タイプ: Float

デフォルト値: 0

PartsSplitterのテスト - MergeTreeからデータを読み取る際に、指定された確率で範囲を交差するものと交差しないものに分割します。

merge_tree_use_const_size_tasks_for_remote_reading

タイプ: Bool

デフォルト値: 1

リモートテーブルから読み取る際に、固定サイズのタスクを使用するかどうか。

metrics_perf_events_enabled

タイプ: Bool

デフォルト値: 0

有効にすると、クエリの実行中に一部のパフォーマンスイベントが測定されます。

metrics_perf_events_list

タイプ: String

デフォルト値:

クエリの実行中に測定されるパフォーマンスメトリクスをコンマで区切ったリスト。空はすべてのイベントを意味します。利用可能なイベントについては、ソースのPerfEventInfoを参照してください。

min_bytes_to_use_direct_io

タイプ: UInt64

デフォルト値: 0

ストレージディスクに対してダイレクトI/Oアクセスを使用するために必要な最小データボリューム。

ClickHouseは、テーブルからデータを読み込む際にこの設定を使用します。読み取るデータの総ストレージボリュームがmin_bytes_to_use_direct_ioバイトを超える場合、ClickHouseはO_DIRECTオプションを使ってストレージディスクからデータを読み取ります。

可能な値:

0 — ダイレクトI/Oは無効。
正の整数。

min_bytes_to_use_mmap_io

タイプ: UInt64

デフォルト値: 0

これはエクスペリメンタルな設定です。カーネルからユーザースペースにデータをコピーしないで大きなファイルを読み取るための最小メモリ量を設定します。推奨されるしきい値は約64 MBです。なぜなら、mmap/munmapは遅いからです。これは大きなファイルのみに意味があり、データがページキャッシュに存在する場合にのみ役立ちます。

可能な値:

正の整数。
0 — 大きなファイルはカーネルからユーザースペースにデータをコピーするのみで読み込まれます。

min_chunk_bytes_for_parallel_parsing

タイプ: UInt64

デフォルト値: 10485760

タイプ: 正の整数
デフォルト値: 1 MiB

各スレッドが並行して解析する最小チャンクサイズ（バイト単位）。

min_compress_block_size

タイプ: UInt64

デフォルト値: 65536

MergeTreeテーブル用。クエリ処理時のレイテンシを減少させるために、次のマークを書き込む際、そのサイズがmin_compress_block_size以上であればブロックが圧縮されます。デフォルトは65,536です。

未圧縮データの実際のサイズがmax_compress_block_size未満であれば、ブロックのサイズはこの値以上、かつ1マーク分のデータ量以上でなければなりません。

例を見てみましょう。index_granularityがテーブル作成時に8192に設定されていたとします。

UInt32型のカラム（値あたり4バイト）を書き込む場合。8192行を書き込むと、合計32 KBのデータになります。min_compress_block_sizeが65,536であるため、2マークごとに圧縮ブロックが形成されます。

URL型のカラム（平均サイズ60バイト）の場合も見てみましょう。8192行を書き込むと、平均で500 KB弱のデータになります。これは65,536を超えているため、各マークごとに圧縮ブロックが形成されます。この場合、ディスクから単一のマークの範囲を読み込むときに余分なデータは解凍されません。

:::note これは専門家向けの設定であり、ClickHouseを使用し始めたばかりの人が変更するべきではありません。 :::

min_count_to_compile_aggregate_expression

タイプ: UInt64

デフォルト値: 3

JITコンパイルを開始するための同一の集約式の最小数。この設定は、compile_aggregate_expressionsが有効になっている場合にのみ機能します。

可能な値:

正の整数。
0 — 同一の集約式は常にJITコンパイルされます。

min_insert_block_size_bytes

タイプ: UInt64

デフォルト値: 268402944

INSERTクエリによってテーブルに挿入できるブロック内の最小バイト数を設定します。小さいサイズのブロックは大きなブロックに圧縮されます。

可能な値:

正の整数。
0 — 圧縮無効。

min_insert_block_size_bytes_for_materialized_views

タイプ: UInt64

デフォルト値: 0

INSERTクエリによってテーブルに挿入できるブロック内の最小バイト数を設定します。小さいサイズのブロックは大きなブロックに圧縮されます。この設定は、マテリアライズドビューに挿入されるブロックのみに適用されます。この設定を調整することで、マテリアライズドビューにプッシュする際のブロック圧縮を制御し、過剰なメモリ使用を回避します。

可能な値:

任意の正の整数。
0 — 圧縮無効。

詳細情報

min_insert_block_size_bytes

min_insert_block_size_rows

タイプ: UInt64

デフォルト値: 1048449

INSERTクエリによってテーブルに挿入できるブロック内の最小行数を設定します。小さいサイズのブロックは大きなブロックに圧縮されます。

可能な値:

正の整数。
0 — 圧縮無効。

min_insert_block_size_rows_for_materialized_views

タイプ: UInt64

デフォルト値: 0

INSERTクエリによってテーブルに挿入できるブロック内の最小行数を設定します。小さいサイズのブロックは大きなブロックに圧縮されます。この設定は、マテリアライズドビューに挿入されるブロックのみに適用されます。この設定を調整することで、マテリアライズドビューにプッシュする際のブロック圧縮を制御し、過剰なメモリ使用を回避します。

可能な値:

任意の正の整数。
0 — 圧縮無効。

詳細情報

min_insert_block_size_rows

可能な値:

0 - 変異は非同期で実行されます。
1 - クエリは現在のサーバー上で全ての変異が完了するのを待ちます。
2 - クエリは全てのレプリカ（存在する場合）で全ての変異が完了するのを待ちます。

mysql_datatypes_support_level

タイプ: MySQLDataTypesSupport

デフォルト値:

MySQLデータ型がそれに対応するClickHouseデータ型に変換される方法を定義します。decimal、datetime64、date2Date32またはdate2Stringのいずれかの組み合わせにコンマで区切られたリスト。

decimal: 精度が許す限り、NUMERICおよびDECIMAL型をDecimalに変換します。
datetime64: 精度が0でない場合、DATETIMEおよびTIMESTAMP型をDateTime64に変換します。
date2Date32: DATEをDate32に変換します（Dateの代わりに）。これはdate2Stringより優先されます。
date2String: DATEをStringに変換します（Dateの代わりに）。datetime64によって上書きされます。

mysql_map_fixed_string_to_text_in_show_columns

タイプ: Bool

デフォルト値: 1

有効にすると、FixedStringのClickHouseデータ型は、SHOW COLUMNSでTEXTとして表示されます。

これは、MySQLワイヤプロトコルを介して接続されている場合にのみ有効です。

0 - BLOBを使用。
1 - TEXTを使用。

mysql_map_string_to_text_in_show_columns

タイプ: Bool

デフォルト値: 1

有効にすると、StringのClickHouseデータ型は、SHOW COLUMNSでTEXTとして表示されます。

これは、MySQLワイヤプロトコルを介して接続されている場合にのみ有効です。

0 - BLOBを使用。
1 - TEXTを使用。

mysql_max_rows_to_insert

タイプ: UInt64

デフォルト値: 65536

MySQLストレージエンジンのMySQLバッチ挿入における最大行数。

network_compression_method

タイプ: String

デフォルト値: LZ4

サーバー間およびサーバーとclickhouse-client間の通信に使用されるデータ圧縮方式を設定します。

可能な値:

LZ4 — LZ4圧縮方式を設定。
ZSTD — ZSTD圧縮方式を設定。

詳細情報

network_zstd_compression_level

network_zstd_compression_level

タイプ: Int64

デフォルト値: 1

ZSTD圧縮のレベルを調整します。network_compression_methodがZSTDに設定されているときのみ使用されます。

可能な値:

1から15までの正の整数。

可能な値:

0 — 行はスキップされません。
正の整数。

例

入力テーブル:

CREATE TABLE test (i UInt64) ENGINE = MergeTree() ORDER BY i;
INSERT INTO test SELECT number FROM numbers(500);

クエリ:

SET limit = 5;
SET offset = 7;
SELECT * FROM test LIMIT 10 OFFSET 100;

結果:

┌───i─┐
│ 107 │
│ 108 │
│ 109 │
└─────┘

opentelemetry_start_trace_probability

タイプ: Float

デフォルト値: 0

ClickHouseが実行されたクエリのトレースを開始できる確率を設定します（親トレースコンテキストが提供されていない場合）。

可能な値:

0 — 実行されたすべてのクエリのトレースが無効になります（親トレースコンテキストが提供されていない場合）。
0..1の範囲内の正の浮動小数点数。例えば、設定値が0.5の場合、ClickHouseは平均して半分のクエリでトレースを開始することができます。
1 — 実行されたすべてのクエリのトレースが有効になります。

opentelemetry_trace_processors

タイプ: Bool

デフォルト値: 0

プロセッサのためにOpenTelemetryスパンを収集します。

optimize_aggregation_in_order

タイプ: Bool

デフォルト値: 0

MergeTreeテーブルのデータを対応する順序で集約するためにSELECTクエリのGROUP BY最適化を有効にします。

可能な値:

0 — GROUP BY最適化は無効。
1 — GROUP BY最適化は有効。

詳細情報

GROUP BY最適化

optimize_aggregators_of_group_by_keys

タイプ: Bool

デフォルト値: 1

SELECTセクションでGROUP BYキーの最小/最大/any/anyLastアグリゲーターを排除します。

optimize_append_index

タイプ: Bool

デフォルト値: 0

インデックス条件を追加するために制約を使用します。デフォルトはfalseです。

可能な値:

true, false

optimize_arithmetic_operations_in_aggregate_functions

タイプ: Bool

デフォルト値: 1

集約関数の外で算術演算を移動します。

optimize_count_from_files

タイプ: Bool

デフォルト値: 1

異なる入力形式のファイルからの行数のカウントの最適化を有効または無効にします。これはテーブル関数/エンジンfile/s3/url/hdfs/azureBlobStorageに適用されます。

可能な値:

0 — 最適化無効。
1 — 最適化有効。

optimize_distinct_in_order

タイプ: Bool

デフォルト値: 1

DISTINCTの最適化を有効にし、DISTINCTの一部のカラムがソートのプレフィックスを形成する場合に適用されます。例えば、マージツリーまたはORDER BYステートメントのソートキーのプレフィックス。

optimize_distributed_group_by_sharding_key

タイプ: Bool

デフォルト値: 1

コストのかかるイニシエーターサーバーでの集約を避けることにより、GROUP BY sharding_keyクエリを最適化します。これにより、イニシエーターサーバーでのメモリ使用量が削減されます。以下のタイプのクエリがサポートされています（そのすべての組み合わせも含まれます）：

SELECT DISTINCT [..., ]sharding_key[, ...] FROM dist
SELECT ... FROM dist GROUP BY sharding_key[, ...]
SELECT ... FROM dist GROUP BY sharding_key[, ...] ORDER BY x
SELECT ... FROM dist GROUP BY sharding_key[, ...] LIMIT 1
SELECT ... FROM dist GROUP BY sharding_key[, ...] LIMIT 1 BY x

次の種類のクエリはサポートされていません（いくつかは後でサポートされる可能性があります）：

SELECT ... GROUP BY sharding_key[, ...] WITH TOTALS
SELECT ... GROUP BY sharding_key[, ...] WITH ROLLUP
SELECT ... GROUP BY sharding_key[, ...] WITH CUBE
SELECT ... GROUP BY sharding_key[, ...] SETTINGS extremes=1

可能な値：

0 — 無効。
1 — 有効。

参照：

distributed_group_by_no_merge
distributed_push_down_limit
optimize_skip_unused_shards

:::note 現在のところ、optimize_skip_unused_shardsが必要です（これには、データが分散テーブル経由で挿入され、そのためデータがsharding_keyに従って分散されている場合にのみ正しく動作するという理由があります）。 :::

optimize_functions_to_subcolumns

タイプ: Bool

デフォルト値: 1

サブカラムの読み込みに変換することによって最適化を有効または無効にします。これにより、読み込むデータの量が減ります。

これらの関数は変換可能です：

lengthをサイズ0サブカラムを読み込むために使用。
emptyをサイズ0サブカラムを読み込むために使用。
notEmptyをサイズ0サブカラムを読み込むために使用。
isNullをnullableサブカラムを読み込むために使用。
isNotNullをnullableサブカラムを読み込むために使用。
countをnullableサブカラムを読み込むために使用。
mapKeysをkeysサブカラムを読み込むために使用。
mapValuesをvaluesサブカラムを読み込むために使用。

可能な値：

0 — 最適化無効。
1 — 最適化有効。

optimize_move_to_prewhere

タイプ: Bool

デフォルト値: 1

SELECTクエリでの自動PREFIX最適化を有効または無効にします。

これは*MergeTreeテーブルにのみ適用されます。

可能な値：

0 — 自動PREWHERE最適化無効。
1 — 自動PREWHERE最適化有効。

optimize_move_to_prewhere_if_final

タイプ: Bool

デフォルト値: 0

FINAL修飾子を持つSELECTクエリにおける自動PREFIX最適化を有効または無効にします。

これは*MergeTreeテーブルにのみ適用されます。

可能な値：

0 — FINAL修飾子のあるSELECTクエリでの自動PREWHERE最適化無効。
1 — FINAL修飾子のあるSELECTクエリでの自動PREWHERE最適化有効。

参照

optimize_move_to_prewhere設定

optimize_multiif_to_if

タイプ: Bool

デフォルト値: 1

multiIfの条件を1つに置き換えます。

optimize_normalize_count_variants

タイプ: Bool

デフォルト値: 1

semantically equal count()として集計関数を再記述します。

optimize_on_insert

タイプ: Bool

デフォルト値: 1

挿入の前にデータ変換を有効または無効にします。これは、テーブルエンジンに従って（マージがこのブロックで実行されたかのように）行われます。

可能な値：

0 — 無効。
1 — 有効。

例

有効と無効の違い：

クエリ：

SET optimize_on_insert = 1;

CREATE TABLE test1 (`FirstTable` UInt32) ENGINE = ReplacingMergeTree ORDER BY FirstTable;

INSERT INTO test1 SELECT number % 2 FROM numbers(5);

SELECT * FROM test1;

SET optimize_on_insert = 0;

CREATE TABLE test2 (`SecondTable` UInt32) ENGINE = ReplacingMergeTree ORDER BY SecondTable;

INSERT INTO test2 SELECT number % 2 FROM numbers(5);

SELECT * FROM test2;

結果：

┌─FirstTable─┐
│          0 │
│          1 │
└────────────┘

┌─SecondTable─┐
│           0 │
│           0 │
│           0 │
│           1 │
│           1 │
└─────────────┘

この設定はMaterialized viewやMaterializedMySQLの動作に影響を与えることに注意してください。

optimize_or_like_chain

タイプ: Bool

デフォルト値: 0

複数のOR LIKEをmultiMatchAnyに最適化します。この最適化はデフォルトでは無効にすべきです。なぜなら、場合によってはインデックス分析を無効にするためです。

optimize_read_in_order

タイプ: Bool

デフォルト値: 1

MergeTreeテーブルからデータを読み取るためのORDER BY最適化を有効または無効にします。

可能な値：

0 — ORDER BY最適化無効。
1 — ORDER BY最適化有効。

参照

ORDER BY句

optimize_read_in_window_order

タイプ: Bool

デフォルト値: 1

MergeTreeテーブルでのウィンドウ句におけるORDER BY最適化を有効にします。

optimize_redundant_functions_in_order_by

タイプ: Bool

デフォルト値: 1

ORDER BY内の引数がORDER BYに含まれている場合、ORDER BYから関数を削除します。

optimize_respect_aliases

タイプ: Bool

デフォルト値: 1

この設定がtrueに設定されている場合、WHERE/GROUP BY/ORDER BY内のエイリアスを尊重し、パーティションプルーニング/セカンダリインデックス/optimize_aggregation_in_order/optimize_read_in_order/optimize_trivial_countで助けになります。

optimize_rewrite_aggregate_function_with_if

タイプ: Bool

デフォルト値: 1

論理的に等しい場合、if式を引数とする集計関数を再記述します。たとえば、avg(if(cond, col, null))はavgOrNullIf(cond, col)に再記述できます。性能を改善する可能性があります。

:::note これは分析器（enable_analyzer = 1）でのみサポートされます。 :::

optimize_rewrite_array_exists_to_has

タイプ: Bool

デフォルト値: 0

論理的に等しい場合、arrayExists()関数をhas()に再記述します。たとえば、arrayExists(x -> x = 1, arr)はhas(arr, 1)に再記述できます。

optimize_rewrite_sum_if_to_count_if

タイプ: Bool

デフォルト値: 1

論理的に等しい場合、sumIf()およびsum(if())関数をcountIf()関数に再記述します。

optimize_skip_merged_partitions

タイプ: Bool

デフォルト値: 0

一つのパーティションにアクティブなパーツが1つだけあり、期限切れのTTLがない場合に、OPTIMIZE TABLE ... FINALクエリのための最適化を有効または無効にします。

OPTIMIZE TABLE ... FINAL SETTINGS optimize_skip_merged_partitions=1

デフォルトでは、OPTIMIZE TABLE ... FINALクエリは、単一の部分があっても書き換えられます。

可能な値：

1 - 最適化有効。
0 - 最適化無効。

optimize_skip_unused_shards

タイプ: Bool

デフォルト値: 0

WHERE/PREWHEREの条件にsharding keyが含まれているSELECTクエリに対して未使用のシャードのスキップを有効または無効にします（データがsharding keyによって分散されていると仮定）。さもなければ、クエリは不正確な結果を返します。

可能な値：

0 — 無効。
1 — 有効。

optimize_skip_unused_shards_limit

タイプ: UInt64

デフォルト値: 1000

sharding key値の制限で、制限に達することによってoptimize_skip_unused_shardsをオフにします。

あまりにも多くの値があると処理に多大な時間がかかる可能性がありますが、利益は疑わしいです。なぜなら、IN (...)内に大量の値がある場合、ほとんどの場合、クエリはすべてのシャードに送信されるためです。

optimize_skip_unused_shards_nesting

タイプ: UInt64

デフォルト値: 0

分散クエリのネストレベルに応じてoptimize_skip_unused_shardsを制御します（たとえば、別のDistributedテーブルを参照するDistributedテーブルがある場合）。

可能な値：

0 — 無効、optimize_skip_unused_shardsは常に動作します。
1 — 最初のレベルに対してのみoptimize_skip_unused_shardsを有効にします。
2 — 2番目のレベルまでoptimize_skip_unused_shardsを有効にします。

optimize_skip_unused_shards_rewrite_in

タイプ: Bool

デフォルト値: 1

リモートシャードのクエリ内のINを再記述し、シャードに属さない値を除外します（optimize_skip_unused_shardsが必要です）。

可能な値：

0 — 無効。
1 — 有効。

optimize_sorting_by_input_stream_properties

タイプ: Bool

デフォルト値: 1

入力ストリームのプロパティによるソートを最適化します。

optimize_substitute_columns

タイプ: Bool

デフォルト値: 0

制約を使用してカラムの代替を行います。デフォルト値はfalseです。

可能な値：

true, false

optimize_syntax_fuse_functions

タイプ: Bool

デフォルト値: 0

同一引数を持つ集計関数を融合させます。これは、sum、count、またはavgの同一引数を持つ少なくとも2つの集計関数をsumCountに書き換えます。

可能な値：

0 — 同一引数を持つ関数は融合されない。
1 — 同一引数を持つ関数は融合される。

例

クエリ：

CREATE TABLE fuse_tbl(a Int8, b Int8) Engine = Log;
SET optimize_syntax_fuse_functions = 1;
EXPLAIN SYNTAX SELECT sum(a), sum(b), count(b), avg(b) from fuse_tbl FORMAT TSV;

結果：

SELECT
    sum(a),
    sumCount(b).1,
    sumCount(b).2,
    (sumCount(b).1) / (sumCount(b).2)
FROM fuse_tbl

optimize_throw_if_noop

タイプ: Bool

デフォルト値: 0

マージを実行しなかった場合、OPTIMIZEクエリが例外をスローするかどうかを有効または無効にします。

デフォルトでは、OPTIMIZEは何も行わなかった場合でも正常に戻ります。この設定を使用すると、これらの状況を区別し、例外メッセージで理由を取得できます。

可能な値：

1 — 例外をスローすることを有効にします。
0 — 例外をスローすることを無効にします。

optimize_time_filter_with_preimage

タイプ: Bool

デフォルト値: 1

変換なしで関数を同等の比較に変換することによって、日付および日時の述語を最適化します（例：toYear(col) = 2023 -> col >= '2023-01-01' AND col <= '2023-12-31'）。

optimize_trivial_approximate_count_query

タイプ: Bool

デフォルト値: 0

この最適化をサポートするストレージのトリビアルカウントの近似値を使用します。たとえば、EmbeddedRocksDB。

可能な値：

0 — 最適化無効。
1 — 最適化有効。

optimize_trivial_count_query

タイプ: Bool

デフォルト値: 1

MergeTreeのメタデータを使用して、テーブルからSELECT count()のトリビアルクエリの最適化を有効または無効にします。行レベルのセキュリティを使用する必要がある場合は、この設定を無効にしてください。

可能な値：

0 — 最適化無効。
1 — 最適化有効。

参照：

optimize_functions_to_subcolumns

optimize_trivial_insert_select

タイプ: Bool

デフォルト値: 0

トリビアルな'INSERT INTO table SELECT ... FROM TABLES'クエリを最適化します。

optimize_uniq_to_count

タイプ: Bool

デフォルト値: 1

uniqおよびそのバリアント（uniqUpToを除く）を、サブクエリにdistinctまたはgroup by句がある場合にcountに書き換えます。

optimize_use_implicit_projections

タイプ: Bool

デフォルト値: 1

SELECTクエリを実行するために暗黙の投影を自動的に選択します。

optimize_use_projections

タイプ: Bool

デフォルト値: 1

SELECTクエリを処理する際のプロジェクション最適化を有効または無効にします。

可能な値：

0 — プロジェクション最適化無効。
1 — プロジェクション最適化有効。

optimize_using_constraints

タイプ: Bool

デフォルト値: 0

クエリ最適化のために制約を使用します。デフォルトではfalseです。

可能な値：

true, false

os_thread_priority

タイプ: Int64

デフォルト値: 0

クエリを実行するスレッドの優先度（nice)を設定します。OSスケジューラーは、この優先度を考慮して、各利用可能なCPUコアで次に実行するスレッドを選択します。

:::note この設定を使用するには、CAP_SYS_NICE の能力を設定する必要があります。clickhouse-serverパッケージは、インストール中にこれを設定します。一部の仮想環境では、CAP_SYS_NICEの設定が許可されていません。この場合、clickhouse-serverは起動時にそのメッセージを表示します。 :::

可能な値：

値は[-20, 19]の範囲で設定できます。

値が低いほど、優先度が高くなります。優先度の低いniceのスレッドは、優先度の高いスレッドよりも頻繁に実行されます。高い値は、長期間実行される非対話型クエリに好ましいです。なぜなら、これにより、短期間の対話型クエリが到着したときに、リソースをすばやく譲渡できるからです。

output_format_compression_level

タイプ: UInt64

デフォルト値: 3

クエリ出力が圧縮されている場合のデフォルトの圧縮レベル。この設定は、SELECTクエリがINTO OUTFILEを持っている場合、またはテーブル関数file、url、hdfs、s3、またはazureBlobStorageに書き込む場合に適用されます。

可能な値：1から22まで。

output_format_compression_zstd_window_log

タイプ: UInt64

デフォルト値: 0

出力圧縮メソッドがzstdの場合に使用できます。0より大きい場合、この設定は圧縮ウィンドウのサイズ（2の冪）を明示的に設定し、zstd圧縮のロングレンジモードを有効にします。これにより、圧縮率が向上する可能性があります。

可能な値：非負の数。ただし、値が小さすぎるか大きすぎると、zstdlibは例外をスローします。典型的な値は20（ウィンドウサイズ=1MB）から30（ウィンドウサイズ=1GB）までです。

output_format_parallel_formatting

タイプ: Bool

デフォルト値: 1

データフォーマットの並列フォーマットを有効または無効にします。サポートされるのは、TSV、TSKV、CSVおよびJSONEachRowフォーマットのみです。

可能な値：

1 — 有効。
0 — 無効。

page_cache_inject_eviction

タイプ: Bool

デフォルト値: 0

ユーザースペースのページキャッシュは、ランダムにいくつかのページを無効にする場合があります。テスト用です。

parallel_distributed_insert_select

タイプ: UInt64

デフォルト値: 0

並列分散INSERT ... SELECTクエリを有効にします。

INSERT INTO distributed_table_a SELECT ... FROM distributed_table_bクエリを実行した場合、両方のテーブルが同じクラスタを使用し、両方のテーブルがレプリケートされたまたは非レプリケートである場合、このクエリは各シャードでローカルに処理されます。

可能な値：

0 — 無効。
1 — SELECTが分散エンジンの基になるテーブルの各シャードで実行されます。
2 — SELECTおよびINSERTが分散エンジンの基になるテーブルの各シャードで実行されます。

parallel_replica_offset

タイプ: UInt64

デフォルト値: 0

これは内部設定であり、直接使用すべきではなく、'parallel replicas'モードの実装の詳細を表します。この設定は、並列レプリカの中でクエリ処理に参加しているレプリカのインデックスを示すために、分散クエリのイニシエーターサーバーによって自動的に設定されます。

parallel_replicas_allow_in_with_subquery

タイプ: Bool

デフォルト値: 1

trueの場合、INのサブクエリはすべてのフォロワーレプリカで実行されます。

parallel_replicas_count

タイプ: UInt64

デフォルト値: 0

これは内部設定であり、直接使用すべきではなく、'parallel replicas'モードの実装の詳細を表します。この設定は、分散クエリのイニシエーターサーバーによって、クエリ処理に参加する並列レプリカの数を自動的に設定されます。

parallel_replicas_custom_key

タイプ: String

デフォルト値:

特定のテーブル間でレプリカ間の作業を分割するために使用できる任意の整数式。値は任意の整数式を取ることができます。

主キーを使用した単純な式が推奨されます。

この設定が、複数のレプリカを持つ単一のシャードで構成されるクラスタで使用されている場合、これらのレプリカは仮想シャードに変換されます。そうでなければ、それはSAMPLEキーと同じように動作し、各シャードの複数のレプリカを使用します。

parallel_replicas_custom_key_range_lower

タイプ: UInt64

デフォルト値: 0

フィルタータイプrangeがカスタム範囲[parallel_replicas_custom_key_range_lower, INT_MAX]に基づいてレプリカ間で作業を均等に分割できるようにします。

parallel_replicas_custom_key_range_upperと併用することで、カスタムキー範囲に基づいてレプリカ間で作業を均等に分割することができます。

注意：この設定は、クエリ処理中に追加のデータがフィルタリングされることはなく、並列処理のために範囲[0, INT_MAX]が分割されるポイントを変更します。

parallel_replicas_custom_key_range_upper

タイプ: UInt64

タイプ: UInt64

デフォルト値: 65536

JOINクエリの部分的マージJOINアルゴリズムで、右側のJOINデータブロックのサイズを制限します。

ClickHouseサーバーは：

右側のJOINデータを指定された行数のブロックに分割します。
各ブロックをその最小値と最大値でインデックス化します。
可能であれば準備されたブロックをディスクにアンロードします。

可能な値：

任意の正の整数。推奨される値の範囲：[1000, 100000]。

prefer_column_name_to_alias

タイプ: Bool

デフォルト値: 0

クエリ式および句内でエイリアスの代わりに元のカラム名を使用するかどうかを有効または無効にします。これは、エイリアスがカラム名と同じである場合に特に重要です。Expression Aliasesを参照してください。この設定を有効にすると、ClickHouseのエイリアス構文ルールはほとんどの他のデータベースエンジンとより互換性が高くなります。

可能な値：

0 — カラム名はエイリアスに置き換えられます。
1 — カラム名はエイリアスに置き換えられません。

例

有効と無効の違い：

クエリ：

SET prefer_column_name_to_alias = 0;
SELECT avg(number) AS number, max(number) FROM numbers(10);

結果：

Received exception from server (version 21.5.1):
Code: 184. DB::Exception: Received from localhost:9000. DB::Exception: Aggregate function avg(number) is found inside another aggregate function in query: While processing avg(number) AS number.

クエリ：

SET prefer_column_name_to_alias = 1;
SELECT avg(number) AS number, max(number) FROM numbers(10);

結果：

┌─number─┬─max(number)─┐
│    4.5 │           9 │
└────────┴─────────────┘

prefer_external_sort_block_bytes

タイプ: UInt64

デフォルト値: 16744704

外部ソートのための最大ブロックバイトを優先し、マージ時のメモリ使用量を削減します。

prefer_global_in_and_join

タイプ: Bool

デフォルト値: 0

IN/JOIN演算子をGLOBAL IN/GLOBAL JOINに置き換えることを有効または無効にします。

可能な値：

0 — 無効。 IN/JOIN演算子はGLOBAL IN/GLOBAL JOINに置き換えられません。
1 — 有効。 IN/JOIN演算子はGLOBAL IN/GLOBAL JOINに置き換えられます。

使用方法

SET distributed_product_mode=globalが分散テーブルに対するクエリの動作を変更することがありますが、ローカルテーブルや外部リソースのテーブルには適していません。この時にprefer_global_in_and_join設定が登場します。

たとえば、ローカルテーブルが含まれるクエリ処理ノードがあり、これらは分散処理に適していません。GLOBALキーワードを使用して分散処理中にデータをその場で散らばらせる必要があります—GLOBAL IN/GLOBAL JOINを使用します。

`prefer_global_in_and_join`のもう一つの使用例は、外部エンジンによって作成されたテーブルにアクセスすることです。この設定は、そのようなテーブルを結合する際に外部ソースへの呼び出し回数を減らすのに役立ちます：クエリごとに1回の呼び出しのみです。

**参照：**

- `GLOBAL IN`/`GLOBAL JOIN`の使用方法についての詳細は、[分散サブクエリ](../../sql-reference/operators/in.md/#select-distributed-subqueries)を参照してください。

## prefer_localhost_replica {#prefer_localhost_replica}

タイプ: Bool

デフォルト値: 1

分散クエリを処理する際に、ローカルホストのレプリカを優先的に使用するかどうかを有効/無効にします。

可能な値：

- 1 — ClickHouseはローカルホストのレプリカが存在する場合、常にクエリをそのレプリカに送信します。
- 0 — ClickHouseは、[load_balancing](#load_balancing)設定で指定されたバランス戦略を使用します。

:::note
[parallel_replicas_custom_key](#parallel_replicas_custom_key)を使用せずに[max_parallel_replicas](#max_parallel_replicas)を使用している場合は、この設定を無効にしてください。
[parallel_replicas_custom_key](#parallel_replicas_custom_key)が設定されている場合、複数のレプリカを含む複数のシャードを持つクラスターで使用する場合にのみ、この設定を無効にしてください。
単一のシャードと複数のレプリカを持つクラスターで使用する場合、この設定を無効にすると悪影響があります。
:::

## prefer_warmed_unmerged_parts_seconds {#prefer_warmed_unmerged_parts_seconds}

タイプ: Int64

デフォルト値: 0

ClickHouse Cloudでのみ利用可能です。マージされていない部分がこの秒数未満で古く、プリウォームされていない場合（cache_populated_by_fetchを参照）、かつすべてのソース部分が利用可能でプリウォームされている場合、SELECTクエリはそれらの部分から読み取ります。ReplicatedMergeTree専用です。この設定は、CacheWarmerがその部分を処理したかどうかのみをチェックします。もしその部分が他の何かによってキャッシュに取得されていても、CacheWarmerがそれを処理するまで「コールド」と見なされます。もしプリウォームされてキャッシュから排除された場合も、「ウォーム」と見なされます。

## preferred_block_size_bytes {#preferred_block_size_bytes}

タイプ: UInt64

デフォルト値: 1000000

この設定は、クエリ処理のためのデータブロックサイズを調整し、粗い 'max_block_size' 設定に対する追加的な微調整を表します。カラムが大きく、'max_block_size' 行が指定されたバイト数よりも大きい場合、そのサイズはCPUキャッシュの局所性を改善するために低くされます。

## preferred_max_column_in_block_size_bytes {#preferred_max_column_in_block_size_bytes}

タイプ: UInt64

デフォルト値: 0

読み取り時のブロック内の最大カラムサイズの制限です。キャッシュミスの回数を減少させるのに役立ちます。L2キャッシュサイズに近い必要があります。

## preferred_optimize_projection_name {#preferred_optimize_projection_name}

タイプ: String

デフォルト値: 

空でない文字列に設定されている場合、ClickHouseはクエリで指定されたプロジェクションを適用しようとします。

可能な値：

- 文字列: 好みのプロジェクションの名前

## prefetch_buffer_size {#prefetch_buffer_size}

タイプ: UInt64

デフォルト値: 1048576

ファイルシステムから読み取るためのプリフェッチバッファの最大サイズです。

## print_pretty_type_names {#print_pretty_type_names}

タイプ: Bool

デフォルト値: 1

`DESCRIBE`クエリおよび`toTypeName()`関数内で、深くネストされたタイプの名前をインデントを付けて整形して印刷できるようにします。

例：

```sql
CREATE TABLE test (a Tuple(b String, c Tuple(d Nullable(UInt64), e Array(UInt32), f Array(Tuple(g String, h Map(String, Array(Tuple(i String, j UInt64))))), k Date), l Nullable(String))) ENGINE=Memory;
DESCRIBE TABLE test FORMAT TSVRaw SETTINGS print_pretty_type_names=1;

a   Tuple(
    b String,
    c Tuple(
        d Nullable(UInt64),
        e Array(UInt32),
        f Array(Tuple(
            g String,
            h Map(
                String,
                Array(Tuple(
                    i String,
                    j UInt64
                ))
            )
        )),
        k Date
    ),
    l Nullable(String)
)

priority

タイプ: UInt64

デフォルト値: 0

クエリの優先度。1 - 最も高い、値が高いほど優先度は低い；0 - 優先度を使用しない。

query_cache_compress_entries

タイプ: Bool

デフォルト値: 1

クエリキャッシュ内のエントリを圧縮します。クエリキャッシュのメモリ消費を抑えますが、挿入や読み取りの速度は低下します。

可能な値：

0 - 無効
1 - 有効

query_cache_max_entries

タイプ: UInt64

デフォルト値: 0

現在のユーザーがクエリキャッシュに格納できるクエリ結果の最大数。0は無制限を意味します。

可能な値：

0以上の正の整数。

query_cache_max_size_in_bytes

タイプ: UInt64

デフォルト値: 0

現在のユーザーがクエリキャッシュに割り当てられる最大メモリ量（バイト単位）。0は無制限を意味します。

可能な値：

0以上の正の整数。

query_cache_min_query_duration

タイプ: ミリ秒

デフォルト値: 0

クエリの結果をクエリキャッシュに保存するために、クエリが実行されなければならない最小の時間（ミリ秒単位）。

可能な値：

0以上の正の整数。

query_cache_min_query_runs

タイプ: UInt64

デフォルト値: 0

SELECTクエリが結果をクエリキャッシュに保存する前に、実行する必要がある最小回数。

可能な値：

0以上の正の整数。

query_cache_nondeterministic_function_handling

タイプ: QueryCacheNondeterministicFunctionHandling

デフォルト値: throw

非決定論的関数（例えば、rand()やnow()）を含むSELECTクエリに対してクエリキャッシュがどのように処理するかを制御します。

可能な値：

'throw' - 例外をスローし、クエリ結果をキャッシュしない。
'save' - クエリ結果をキャッシュする。
'ignore' - クエリ結果をキャッシュせず、例外をスローしない。

query_cache_share_between_users

タイプ: Bool

デフォルト値: 0

有効にすると、クエリキャッシュにキャッシュされたSELECTクエリの結果を他のユーザーが読み取れるようになります。この設定を有効にすることは、セキュリティ上の理由から推奨されません。

可能な値：

0 - 無効
1 - 有効

query_cache_squash_partial_results

タイプ: Bool

デフォルト値: 1

部分結果ブロックをmax_block_sizeのサイズのブロックに圧縮します。クエリキャッシュへの挿入のパフォーマンスを低下させますが、キャッシュエントリの圧縮性を向上させます（query_cache_compress-entriesを参照）。

可能な値：

0 - 無効
1 - 有効

query_cache_system_table_handling

タイプ: QueryCacheSystemTableHandling

デフォルト値: throw

システムテーブル（すなわち、system.*およびinformation_schema.*データベースのテーブル）に対するSELECTクエリに対して、クエリキャッシュがどのように処理するかを制御します。

可能な値：

'throw' - 例外をスローし、クエリ結果をキャッシュしない。
'save' - クエリ結果をキャッシュする。
'ignore' - クエリ結果をキャッシュせず、例外をスローしない。

query_cache_tag

タイプ: String

デフォルト値:

クエリキャッシュエントリにラベルとして機能する文字列です。同じクエリが異なるタグを持つ場合、クエリキャッシュでは異なるものと見なされます。

可能な値：

任意の文字列

query_cache_ttl

タイプ: 秒

デフォルト値: 60

この時間（秒単位）を経過すると、クエリキャッシュのエントリが古くなります。

可能な値：

0以上の正の整数。

query_metric_log_interval

タイプ: Int64

デフォルト値: -1

個々のクエリに対するquery_metric_logの収集間隔（ミリ秒単位）です。

任意の負の値に設定された場合、query_metric_log設定からcollect_interval_millisecondsの値を使用するか、存在しない場合は1000にデフォルトされます。

単一クエリの収集を無効にするには、query_metric_log_intervalを0に設定します。

デフォルト値: -1

query_plan_aggregation_in_order

タイプ: Bool

デフォルト値: 1

集約を順序通りに処理するクエリプランレベルの最適化を切り替えます。設定query_plan_enable_optimizationsが1の場合にのみ効果があります。

:::note これは専門家レベルの設定であり、開発者によるデバッグのためにのみ使用するべきです。この設定は、将来的に後方互換性のない方法で変更されたり、削除されたりする可能性があります。 :::

可能な値：

0 - 無効
1 - 有効

query_plan_convert_outer_join_to_inner_join

タイプ: Bool

デフォルト値: 1

JOINの後にフィルタが常にデフォルト値をフィルタリングする場合、OUTER JOINをINNER JOINに変換することを許可します。

query_plan_enable_multithreading_after_window_functions

タイプ: Bool

デフォルト値: 1

ウィンドウ関数を評価した後にマルチスレッド処理を可能にします。

query_plan_enable_optimizations

タイプ: Bool

デフォルト値: 1

クエリプランレベルでのクエリ最適化を切り替えます。

可能な値：

0 - クエリプランレベルでのすべての最適化を無効
1 - クエリプランレベルでの最適化を有効（ただし、個々の最適化は個別の設定で無効にされる可能性があります）

query_plan_execute_functions_after_sorting

タイプ: Bool

デフォルト値: 1

ソート処理の後に式を移動するクエリプランレベルの最適化を切り替えます。設定query_plan_enable_optimizationsが1の場合にのみ効果があります。

可能な値：

0 - 無効
1 - 有効

query_plan_filter_push_down

タイプ: Bool

デフォルト値: 1

実行プランでフィルタを下に移動するクエリプランレベルの最適化を切り替えます。設定query_plan_enable_optimizationsが1の場合にのみ効果があります。

可能な値：

0 - 無効
1 - 有効

query_plan_lift_up_array_join

タイプ: Bool

デフォルト値: 1

ARRAY JOINを実行プランの上部に移動するクエリプランレベルの最適化を切り替えます。設定query_plan_enable_optimizationsが1の場合にのみ効果があります。

可能な値：

0 - 無効
1 - 有効

query_plan_lift_up_union

タイプ: Bool

デフォルト値: 1

クエリプランの大きな部分木を一つのユニオンに移動するクエリプランレベルの最適化を切り替えます。設定query_plan_enable_optimizationsが1の場合にのみ効果があります。

可能な値：

0 - 無効
1 - 有効

query_plan_max_optimizations_to_apply

タイプ: UInt64

デフォルト値: 10000

クエリプランに適用される最適化の総数を制限します。query_plan_enable_optimizations設定を参照してください。複雑なクエリについて長時間の最適化を避けるのに役立ちます。この設定を超える最適化の実際の数がある場合、例外がスローされます。

query_plan_merge_expressions

タイプ: Bool

デフォルト値: 1

連続するフィルタをマージするクエリプランレベルの最適化を切り替えます。設定query_plan_enable_optimizationsが1の場合にのみ効果があります。

可能な値：

0 - 無効
1 - 有効

query_plan_merge_filters

タイプ: Bool

デフォルト値: 0

クエリプラン内のフィルタをマージすることを許可します。

query_plan_optimize_prewhere

タイプ: Bool

デフォルト値: 1

サポートされているストレージのためにフィルタをPREWHERE式にプッシュダウンすることを許可します。

query_plan_push_down_limit

タイプ: Bool

デフォルト値: 1

実行プランでLIMITを下に移動するクエリプランレベルの最適化を切り替えます。設定query_plan_enable_optimizationsが1の場合にのみ効果があります。

可能な値：

0 - 無効
1 - 有効

query_plan_read_in_order

タイプ: Bool

デフォルト値: 1

順序通りに読み取る最適化クエリプランレベルの最適化を切り替えます。設定query_plan_enable_optimizationsが1の場合にのみ効果があります。

可能な値：

0 - 無効
1 - 有効

query_plan_remove_redundant_distinct

タイプ: Bool

デフォルト値: 1

冗長なDISTINCTステップを削除するクエリプランレベルの最適化を切り替えます。設定query_plan_enable_optimizationsが1の場合にのみ効果があります。

可能な値：

0 - 無効
1 - 有効

query_plan_remove_redundant_sorting

タイプ: Bool

デフォルト値: 1

冗長なソートステップを削除するクエリプランレベルの最適化を切り替えます（例えば、サブクエリ内など）。設定query_plan_enable_optimizationsが1の場合にのみ効果があります。

可能な値：

0 - 無効
1 - 有効

query_plan_reuse_storage_ordering_for_window_functions

タイプ: Bool

デフォルト値: 1

ウィンドウ関数のソート時にストレージソートを再使用するクエリプランレベルの最適化を切り替えます。設定query_plan_enable_optimizationsが1の場合にのみ効果があります。

可能な値：

0 - 無効
1 - 有効

query_plan_split_filter

タイプ: Bool

デフォルト値: 1

フィルタを式に分割するクエリプランレベルの最適化を切り替えます。設定query_plan_enable_optimizationsが1の場合にのみ効果があります。

可能な値：

0 - 無効
1 - 有効

query_profiler_cpu_time_period_ns

タイプ: UInt64

デフォルト値: 1000000000

クエリプロファイラのCPUクロックタイマーの期間を設定します。このタイマーはCPU時間のみをカウントします。

可能な値：

正の整数のナノ秒。

推奨値：

      - 単一クエリに対しては10000000（秒に100回）のナノ秒以上。
      - クラスター全体のプロファイリングには1000000000（1秒に1回）。

タイマーをオフにするには0。

ClickHouse Cloudでは一時的に無効です。

参照：

システムテーブルtrace_log

query_profiler_real_time_period_ns

タイプ: UInt64

デフォルト値: 1000000000

クエリプロファイラの実際のクロックタイマーの期間を設定します。実際のクロックタイマーは壁時計時間をカウントします。

可能な値：

正の整数数（ナノ秒）。

推奨値：

      - 単一クエリに対しては10000000（秒に100回）ナノ秒未満。
      - クラスター全体のプロファイリングには1000000000（1秒に1回）。

タイマーをオフにするには0。

ClickHouse Cloudでは一時的に無効です。

参照：

システムテーブルtrace_log

regexp_max_matches_per_row

タイプ: UInt64

デフォルト値: 1000

行ごとに単一の正規表現の最大マッチ数を設定します。extractAllGroupsHorizontal関数で欲張りな正規表現を使用する際のメモリ過負荷から保護するために使用します。

可能な値：

正の整数。

reject_expensive_hyperscan_regexps

タイプ: Bool

デフォルト値: 1

ハイパースキャンで評価するのが高コストになると考えられるパターンを拒否します（NFA状態の爆発による）。

remerge_sort_lowered_memory_bytes_ratio

タイプ: Float

デフォルト値: 2

再マージ後のメモリ使用量がこの比率で減少しない場合、再マージは無効化されます。

remote_filesystem_read_method

タイプ: String

デフォルト値: threadpool

リモートファイルシステムからデータを読み取る方法。readまたはthreadpoolのいずれか。

remote_filesystem_read_prefetch

タイプ: Bool

デフォルト値: 1

リモートファイルシステムからデータを読み取る際にプリフェッチを使用すべきかどうかを示します。

remote_fs_read_backoff_max_tries

タイプ: UInt64

デフォルト値: 5

バックオフのための最大読み取り試行回数です。

remote_fs_read_max_backoff_ms

タイプ: UInt64

デフォルト値: 10000

リモートディスクからデータを読み取ろうとする際の最大待機時間です。

remote_read_min_bytes_for_seek

タイプ: UInt64

デフォルト値: 4194304

リモート読み取り（URL、S3）でseekを実行するために必要な最小バイト数であり、無視して読み取らずに実行します。

rename_files_after_processing

タイプ: String

デフォルト値:

タイプ: String
デフォルト値: 空の文字列

この設定により、fileテーブル関数によって処理されたファイルのリネームパターンを指定できます。オプションが設定されると、fileテーブル関数によって読み取られたすべてのファイルは、処理が成功した場合に指定されたパターンに従ってプレースホルダ付きでリネームされます。

プレースホルダ

%a — 完全な元のファイル名（例: "sample.csv"）。
%f — 拡張子なしの元のファイル名（例: "sample"）。
%e — 元のファイルの拡張子（例: ".csv"）。
%t — タイムスタンプ（マイクロ秒）。
%% — パーセント記号 ("%")。

例

オプション: --rename_files_after_processing="processed_%f_%t%e"
クエリ: SELECT * FROM file('sample.csv')

sample.csvの読み取りが成功した場合、ファイルはprocessed_sample_1683473210851438.csvにリネームされます。

replace_running_query

タイプ: Bool

デフォルト値: 0

HTTPインターフェースを使用する際、'query_id'パラメータを渡すことができます。これは、クエリの識別子として機能する任意の文字列です。この時、同じユーザーから同じ'query_id'のクエリがすでに存在する場合、動作は'replace_running_query'パラメータによって異なります。

0（デフォルト） – 例外をスローし、同じ'query_id'のクエリがすでに実行中の場合、そのクエリを実行できません。

1 – 古いクエリをキャンセルし、新しいクエリを実行し始めます。

このパラメータを1に設定するとセグメンテーション条件の提案を実装することができます。次の文字を入力すると、古いクエリがまだ完了していなければキャンセルされるべきです。

replace_running_query_max_wait_ms

タイプ: ミリ秒

デフォルト値: 5000

replace_running_query設定がアクティブな場合、同じquery_idのクエリを実行するのを待つための時間です。

可能な値：

正の整数。
0 — 同じquery_idのクエリが既に実行されている場合、新しいクエリを実行することを許可しない例外をスローします。

replication_wait_for_inactive_replica_timeout

タイプ: Int64

デフォルト値: 120

非アクティブなレプリカがALTER、OPTIMIZE、またはTRUNCATEクエリを実行するのを待つ時間（秒単位）を指定します。

可能な値：

0 — 待機しない。
負の整数 — 無制限に待機。
正の整数 — 待機する秒数。

restore_replace_external_dictionary_source_to_null

タイプ: Bool

デフォルト値: 0

復元時に外部DictionaryソースをNullに置き換えます。テスト目的に有用です。

restore_replace_external_engines_to_null

タイプ: Bool

デフォルト値: 0

テスト目的のため。すべての外部エンジンをNullに置き換え、外部接続を開始しないようにします。

restore_replace_external_table_functions_to_null

タイプ: Bool

デフォルト値: 0

テスト目的のため。すべての外部テーブル関数をNullに置き換え、外部接続を開始しないようにします。

result_overflow_mode

タイプ: OverflowMode

デフォルト値: throw

制限を超えた場合の処理の方法です。

rewrite_count_distinct_if_with_count_distinct_implementation

タイプ: Bool

デフォルト値: 0

countDistcintIfをcount_distinct_implementation設定で書き換えることを許可します。

可能な値：

true — 許可。
false — 不許可。

s3_allow_parallel_part_upload

タイプ: Bool

デフォルト値: 1

S3のマルチパートアップロードに複数スレッドを使用します。これにより、わずかにメモリ使用量が増加する可能性があります。

s3_check_objects_after_upload

タイプ: Bool

デフォルト値: 0

アップロードが成功したことを確認するために、HEADリクエストでアップロードされた各オブジェクトをS3にチェックします。

s3_connect_timeout_ms

タイプ: UInt64

デフォルト値: 1000

S3ディスクのホストへの接続タイムアウトです。

s3_create_new_file_on_insert

タイプ: Bool

デフォルト値: 0

S3エンジンテーブルへの各挿入時に新しいファイルを作成するかどうかを有効または無効にします。有効にすると、各挿入で次のパターンに似た新しいS3オブジェクトが作成されます：

初期: data.Parquet.gz -> data.1.Parquet.gz -> data.2.Parquet.gzなど。

可能な値：

0 — INSERTクエリはファイルの最後に新しいデータを追加します。
1 — INSERTクエリは新しいファイルを作成します。

s3_disable_checksum

タイプ: Bool

デフォルト値: 0

ファイルをS3に送信する際にチェックサムを計算しない。これにより、ファイルに過剰な処理がかかるのを避け、書き込み速度が向上します。MergeTreeテーブルのデータはClickHouseによってすでにチェックサムされているため、主に安全です。また、S3にHTTPSでアクセスする場合、TLSレイヤーはネットワークを介しての転送中に整合性を提供します。S3に追加のチェックサムを計算することで、深層防御を提供します。

s3_ignore_file_doesnt_exist

タイプ: Bool

デフォルト値: 0

特定のキーを読み取るときにファイルが存在しない場合の無視動作です。

可能な値：

1 — SELECTは空の結果を返します。
0 — SELECTは例外をスローします。

SELECT timeZone(), serverTimeZone() SETTINGS session_timezone = 'Asia/Novosibirsk' FORMAT CSV

"Asia/Novosibirsk","Europe/Berlin"

セッションタイムゾーン'America/Denver'を明示的に指定されていない内側のDateTimeに割り当て:

SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS session_timezone = 'America/Denver' FORMAT TSV

1999-12-13 07:23:23.123

:::warning DateTime/DateTime64を解析するすべての関数がsession_timezoneを尊重するわけではありません。これにより微妙なエラーが生じる可能性があります。以下の例と説明を参照してください。 :::

CREATE TABLE test_tz (`d` DateTime('UTC')) ENGINE = Memory AS SELECT toDateTime('2000-01-01 00:00:00', 'UTC');

SELECT *, timeZone() FROM test_tz WHERE d = toDateTime('2000-01-01 00:00:00') SETTINGS session_timezone = 'Asia/Novosibirsk'
0 rows in set.

SELECT *, timeZone() FROM test_tz WHERE d = '2000-01-01 00:00:00' SETTINGS session_timezone = 'Asia/Novosibirsk'
┌───────────────────d─┬─timeZone()───────┐
│ 2000-01-01 00:00:00 │ Asia/Novosibirsk │
└─────────────────────┴──────────────────┘

これは異なる解析パイプラインによるものです:

明示的に与えられたタイムゾーンなしで使用されるtoDateTime()は、最初のSELECTクエリでsession_timezoneとグローバルタイムゾーンの設定を尊重します。
2番目のクエリでは、文字列からDateTimeが解析され、既存のカラムdの型とタイムゾーンを引き継ぎます。したがって、session_timezoneとグローバルタイムゾーンの設定は尊重されません。

関連情報

timezone

set_overflow_mode

タイプ: OverflowMode

デフォルト値: throw

制限を超えた際に何をするか。

short_circuit_function_evaluation

タイプ: ShortCircuitFunctionEvaluation

デフォルト値: enable

if、multiIf、and、およびor関数を短絡的に計算できるようにします。これにより、これらの関数内の複雑な式の実行を最適化し、予期しない例外（ゼロ除算など）を防ぐのに役立ちます。

可能な値:

enable — 適用可能な関数に対して短絡評価が有効になります（例外をスローする可能性があるか、計算コストの高い場合）。
force_enable — すべての関数に対して短絡評価が有効になります。
disable — 短絡評価が無効になります。

show_table_uuid_in_table_create_query_if_not_nil

タイプ: Bool

デフォルト値: 0

SHOW TABLEクエリの表示を設定します。

可能な値:

0 — クエリはテーブルUUIDなしで表示されます。
1 — クエリはテーブルUUID付きで表示されます。

single_join_prefer_left_table

タイプ: Bool

デフォルト値: 1

識別子の曖昧さがある場合、単一JOINの場合は左側のテーブルを優先します。

skip_download_if_exceeds_query_cache

タイプ: Bool

デフォルト値: 1

クエリキャッシュサイズを超える場合、リモートファイルシステムからのダウンロードをスキップします。

skip_unavailable_shards

タイプ: Bool

デフォルト値: 0

使用できないシャードを静かにスキップするかどうかを有効または無効にします。

シャードはすべてのレプリカが使用できない場合、使用できないと見なされます。レプリカは以下の状況で使用できません:

ClickHouseが何らかの理由でレプリカに接続できない。

レプリカに接続する際、ClickHouseは何度か試みます。これらのすべての試みが失敗した場合、そのレプリカは使用できないと見なされます。
レプリカがDNS経由で解決できない。

レプリカのホスト名がDNSを介して解決できない場合、次の状況が考えられます:
- レプリカのホストにDNSレコードがない。これはダイナミックDNSを持つシステムで発生することがあります。たとえば、Kubernetesのように、ノードがダウンタイム中に解決できないことがあるが、これはエラーではありません。
- 設定エラー。ClickHouseの構成ファイルに誤ったホスト名が含まれています。

可能な値:

1 — スキップが有効。

シャードが利用できなくなった場合、ClickHouseは部分的なデータに基づいた結果を返し、ノードの可用性の問題を報告しません。
0 — スキップが無効。

シャードが利用できない場合、ClickHouseは例外をスローします。

splitby_max_substrings_includes_remaining_string

タイプ: Bool

デフォルト値: 0

引数max_substrings > 0のsplitBy*()関数が残りの文字列を結果配列の最後の要素に含めるかどうかを制御します。

可能な値:

0 - 残りの文字列は結果配列の最後の要素には含まれません。
1 - 残りの文字列は結果配列の最後の要素に含まれます。これはSparkのsplit()関数やPythonの'string.split()'またはgRPCインターフェースの動作です。

可能な値:

1 — プロファイルイベントのトレースが有効。
0 — プロファイルイベントのトレースが無効。

transfer_overflow_mode

タイプ: OverflowMode

デフォルト値: throw

制限を超えた際に何をするか。

transform_null_in

タイプ: Bool

デフォルト値: 0

IN演算子に対するNULL値の平等性を有効にします。

デフォルトでは、NULL値は比較できません。なぜなら、NULLは未定義の値を意味するからです。したがって、比較expr = NULLは常にfalseを返さなければなりません。この設定が有効な場合、NULL = NULLはIN演算子に対してtrueを返します。

可能な値:

0 — IN演算子におけるNULL値の比較はfalseを返します。
1 — IN演算子におけるNULL値の比較はtrueを返します。

例

null_inテーブルを考えます:

┌──idx─┬─────i─┐
│    1 │     1 │
│    2 │  NULL │
│    3 │     3 │
└──────┴───────┘

クエリ:

SELECT idx, i FROM null_in WHERE i IN (1, NULL) SETTINGS transform_null_in = 0;

結果:

┌──idx─┬────i─┐
│    1 │    1 │
└──────┴──────┘

クエリ:

SELECT idx, i FROM null_in WHERE i IN (1, NULL) SETTINGS transform_null_in = 1;

結果:

┌──idx─┬─────i─┐
│    1 │     1 │
│    2 │  NULL │
└──────┴───────┘

関連情報

IN演算子におけるNULL処理

traverse_shadow_remote_data_paths

タイプ: Bool

デフォルト値: 0

system.remote_data_pathsクエリを実行するときに、実際のテーブルデータに加えて凍結データ（シャドウディレクトリ）をトラバースします。

union_default_mode

タイプ: SetOperationMode

デフォルト値:

SELECTクエリの結果を結合するモードを設定します。この設定は、UNIONを使用する際に明示的にUNION ALLまたはUNION DISTINCTを指定しない場合にのみ使用されます。

可能な値:

'DISTINCT' — ClickHouseは重複行を削除し、クエリを結合した結果を出力します。
'ALL' — ClickHouseは重複行を含むすべての行を出力します。
'' — ClickHouseはUNIONで使用されたときに例外を生成します。

UNIONの例を参照してください。

unknown_packet_in_send_data

タイプ: UInt64

デフォルト値: 0

N番目のデータパケットの代わりに不明なパケットを送信します。

use_cache_for_count_from_files

タイプ: Bool

デフォルト値: 1

テーブル関数file / s3 / url / hdfs / azureBlobStorageからのカウント時に行数のキャッシュを有効にします。

デフォルトで有効です。

use_client_time_zone

タイプ: Bool

デフォルト値: 0

サーバーのタイムゾーンを採用するのではなく、DateTime文字列値を解釈するためにクライアントタイムゾーンを使用します。

use_compact_format_in_distributed_parts_names

タイプ: Bool

デフォルト値: 1

Distributedエンジンを持つテーブルに対するバックグラウンド（distributed_foreground_insert）INSERTのためのブロックを格納するためにコンパクトな形式を使用します。

可能な値:

0 — user[:password]@host:port#default_databaseディレクトリ形式を使用します。
1 — [shard{shard_index}[_replica{replica_index}]]ディレクトリ形式を使用します。

:::note

use_compact_format_in_distributed_parts_names=0の場合、クラスタ定義の変更は、バックグラウンドINSERTでは適用されません。
use_compact_format_in_distributed_parts_names=1の場合、クラスタ定義のノードの順序を変更すると、shard_index / replica_indexが変更されるため、注意が必要です。 :::

use_concurrency_control

タイプ: Bool

デフォルト値: 1

サーバーの同時実行制御を遵守します（concurrent_threads_soft_limit_numおよびconcurrent_threads_soft_limit_ratio_to_cores グローバルサーバー設定を参照）。無効にすると、サーバーが過負荷であってもより多くのスレッドを使用することができます（通常の使用には推奨されず、主にテストに必要です）。

use_hedged_requests

タイプ: Bool

デフォルト値: 1

0 - 無効
1 - 有効

use_skip_indexes

タイプ: Bool

デフォルト値: 1

クエリ実行中にデータスキッピングインデックスを使用します。

可能な値:

0 — 無効。
1 — 有効。

use_skip_indexes_if_final

タイプ: Bool

デフォルト値: 0

FINAL修飾子を使用したクエリを実行する際にスキップインデックスを使用するかどうかを制御します。

デフォルトでは、この設定は無効です。なぜなら、スキップインデックスは、最近のデータを含む行（グラニュール）を除外する可能性があり、不正確な結果につながる可能性があるからです。有効にすると、FINAL修飾子を持つクエリでもスキップインデックスが適用され、パフォーマンスが向上する可能性がありますが、最近の更新を見逃すリスクがあります。

可能な値:

0 — 無効。
1 — 有効。

use_structure_from_insertion_table_in_table_functions

タイプ: UInt64

デフォルト値: 2

データからのスキーマ推論の代わりに、挿入テーブルからの構造を使用します。可能な値: 0 - 無効、1 - 有効、2 - 自動。

use_uncompressed_cache

タイプ: Bool

デフォルト値: 0

未圧縮ブロックのキャッシュを使用するかどうか。0または1を受け入れます。デフォルトでは0（無効）。未圧縮キャッシュの使用（MergeTreeファミリのテーブルにのみ）は、多数の短いクエリを扱う際にレイテンシを大幅に減少させ、スループットを増加させることができます。頻繁に短いリクエストを送信するユーザーにはこの設定を有効にします。また、未圧縮キャッシュブロックのサイズを設定するuncompressed_cache_size構成パラメーターに注意してください（構成ファイル内のみ設定） – デフォルトは8GiBです。未圧縮キャッシュは必要に応じて充填され、最も使用されていないデータは自動的に削除されます。

少なくともある程度の大量データ（100万行以上）を読み取るクエリについては、スペースを節約するために自動的に未圧縮キャッシュが無効になります。つまり、use_uncompressed_cache設定は常に1に設定しておくことができます。

use_variant_as_common_type

タイプ: Bool

デフォルト値: 0

引数型に共通の型がない場合、if/multiIf/array/map関数の結果型としてVariant型を使用することを許可します。

例:

SET use_variant_as_common_type = 1;
SELECT toTypeName(if(number % 2, number, range(number))) as variant_type FROM numbers(1);
SELECT if(number % 2, number, range(number)) as variant FROM numbers(5);

┌─variant_type───────────────────┐
│ Variant(Array(UInt64), UInt64) │
└────────────────────────────────┘
┌─variant───┐
│ []        │
│ 1         │
│ [0,1]     │
│ 3         │
│ [0,1,2,3] │
└───────────┘

SET use_variant_as_common_type = 1;
SELECT toTypeName(multiIf((number % 4) = 0, 42, (number % 4) = 1, [1, 2, 3], (number % 4) = 2, 'Hello, World!', NULL)) AS variant_type FROM numbers(1);
SELECT multiIf((number % 4) = 0, 42, (number % 4) = 1, [1, 2, 3], (number % 4) = 2, 'Hello, World!', NULL) AS variant FROM numbers(4);

─variant_type─────────────────────────┐
│ Variant(Array(UInt8), String, UInt8) │
└──────────────────────────────────────┘

┌─variant───────┐
│ 42            │
│ [1,2,3]       │
│ Hello, World! │
│ ᴺᵁᴸᴸ          │
└───────────────┘

SET use_variant_as_common_type = 1;
SELECT toTypeName(array(range(number), number, 'str_' || toString(number))) as array_of_variants_type from numbers(1);
SELECT array(range(number), number, 'str_' || toString(number)) as array_of_variants FROM numbers(3);

┌─array_of_variants_type────────────────────────┐
│ Array(Variant(Array(UInt64), String, UInt64)) │
└───────────────────────────────────────────────┘

┌─array_of_variants─┐
│ [[],0,'str_0']    │
│ [[0],1,'str_1']   │
│ [[0,1],2,'str_2'] │
└───────────────────┘

SET use_variant_as_common_type = 1;
SELECT toTypeName(map('a', range(number), 'b', number, 'c', 'str_' || toString(number))) as map_of_variants_type from numbers(1);
SELECT map('a', range(number), 'b', number, 'c', 'str_' || toString(number)) as map_of_variants FROM numbers(3);

┌─map_of_variants_type────────────────────────────────┐
│ Map(String, Variant(Array(UInt64), String, UInt64)) │
└─────────────────────────────────────────────────────┘

┌─map_of_variants───────────────┐
│ {'a':[],'b':0,'c':'str_0'}    │
│ {'a':[0],'b':1,'c':'str_1'}   │
│ {'a':[0,1],'b':2,'c':'str_2'} │
└───────────────────────────────┘

use_with_fill_by_sorting_prefix

タイプ: Bool

デフォルト値: 1

ORDER BY句でFILL列より前のカラムがソーティングプレフィックスを形成します。ソーティングプレフィックス内で異なる値を持つ行は独立して埋められます。

validate_polygons

タイプ: Bool

デフォルト値: 1

多角形が自己交差または自己接触している場合、pointInPolygon関数で例外をスローするかどうかを有効または無効にします。

可能な値:

0 — 例外をスローすることを無効にします。pointInPolygonは無効な多角形を受け入れ、それらに対して不正確な結果を返す可能性があります。
1 — 例外をスローすることを有効にします。

## wait_changes_become_visible_after_commit_mode {#wait_changes_become_visible_after_commit_mode}

タイプ: TransactionsWaitCSNMode

デフォルト値: wait_unknown

コミットされた変更が最新のスナップショットで実際に見えるようになるまで待機します。

## wait_for_async_insert {#wait_for_async_insert}

タイプ: Bool

デフォルト値: 1

trueの場合、非同期挿入処理の完了を待機します。

## wait_for_async_insert_timeout {#wait_for_async_insert_timeout}

タイプ: 秒

デフォルト値: 120

非同期挿入処理の完了を待つためのタイムアウト。

## wait_for_window_view_fire_signal_timeout {#wait_for_window_view_fire_signal_timeout}

タイプ: 秒

デフォルト値: 10

イベント時間処理においてウィンドウビューの信号発火を待つためのタイムアウト。

## window_view_clean_interval {#window_view_clean_interval}

タイプ: 秒

デフォルト値: 60

古いデータを解放するためのウィンドウビューのクリーン間隔（秒）。

## window_view_heartbeat_interval {#window_view_heartbeat_interval}

タイプ: 秒

デフォルト値: 15

ウォッチクエリが生存していることを示すためのハートビート間隔（秒）。

## workload {#workload}

タイプ: 文字列

デフォルト値: default

リソースにアクセスするために使用されるワークロードの名前。

## write_through_distributed_cache {#write_through_distributed_cache}

タイプ: Bool

デフォルト値: 0

ClickHouse Cloud のみ。分散キャッシュへの書き込みを許可します（S3への書き込みも分散キャッシュによって行われます）。

## zstd_window_log_max {#zstd_window_log_max}

タイプ: Int64

デフォルト値: 0

ZSTD の最大ウィンドウログを選択することができます（これは MergeTree ファミリーには使用されません）。

361 KiB Raw Blame History Unescape Escape

add_http_cors_header

additional_result_filter

additional_table_filters

aggregate_functions_null_for_empty

aggregation_in_order_max_block_bytes

aggregation_memory_efficient_merge_threads

allow_aggregate_partitions_independently

allow_archive_path_syntax

allow_asynchronous_read_from_io_pool_for_merge_tree

allow_changing_replica_until_first_data_packet

allow_create_index_without_type

allow_custom_error_code_in_throwif

allow_ddl

allow_deprecated_database_ordinary

allow_deprecated_error_prone_window_functions

allow_deprecated_snowflake_conversion_functions

allow_deprecated_syntax_for_merge_tree

allow_distributed_ddl

allow_drop_detached

allow_execute_multiif_columnar

allow_experimental_analyzer

allow_experimental_codecs

allow_experimental_database_materialized_mysql

allow_experimental_database_materialized_postgresql

allow_experimental_dynamic_type

allow_experimental_full_text_index

allow_experimental_funnel_functions

allow_experimental_hash_functions

allow_experimental_inverted_index

allow_experimental_join_condition

allow_experimental_join_right_table_sorting

allow_experimental_json_type

allow_experimental_kafka_offsets_storage_in_keeper

allow_experimental_live_view

allow_experimental_materialized_postgresql_table

allow_experimental_nlp_functions

allow_experimental_object_type

allow_experimental_parallel_reading_from_replicas

allow_experimental_query_deduplication

allow_experimental_shared_set_join

allow_experimental_statistics

allow_experimental_time_series_table

allow_experimental_variant_type

allow_experimental_vector_similarity_index

allow_experimental_window_view

allow_get_client_http_header

allow_hyperscan

allow_introspection_functions

allow_materialized_view_with_bad_select

allow_named_collection_override_by_default

allow_non_metadata_alters

allow_nonconst_timezone_arguments

allow_nondeterministic_mutations

allow_nondeterministic_optimize_skip_unused_shards

allow_prefetched_read_pool_for_local_filesystem

allow_prefetched_read_pool_for_remote_filesystem

allow_push_predicate_when_subquery_contains_with

allow_reorder_prewhere_conditions

allow_settings_after_format_in_insert

allow_simdjson

allow_statistics_optimize

allow_suspicious_codecs

allow_suspicious_fixed_string_types

allow_suspicious_indices

allow_suspicious_low_cardinality_types

allow_suspicious_primary_key

allow_suspicious_ttl_expressions

allow_suspicious_types_in_group_by

allow_suspicious_types_in_order_by

allow_suspicious_variant_types

allow_unrestricted_reads_from_keeper

alter_move_to_space_execute_async

alter_partition_verbose_result

alter_sync

analyze_index_with_space_filling_curves

analyzer_compatibility_join_using_top_level_identifier

any_join_distinct_right_table_keys

apply_deleted_mask

apply_mutations_on_fly

361 KiB

Raw Blame History