Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

ignore_* セッション設定

View as MarkdownEdit this pageReport an issueSet up docs MCP

これらの設定は system.settings で確認でき、ソースコード から自動生成されています。

ignore_cold_parts_seconds

ClickHouse Cloud 専用
型
Int64
デフォルト値
0

ClickHouse Cloud でのみ有効です。新しいデータパーツは、事前にウォームアップされる (cache_populated_by_fetch を参照) か、この秒数が経過するまで、SELECT クエリから除外されます。Replicated-/SharedMergeTree でのみ有効です。

ignore_data_skipping_indices

クエリで使用される指定のデータスキップ索引を無視します。

次の例を見てみましょう。

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=''; -- query will produce CANNOT_PARSE_TEXT error.
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' ; -- query will produce INDEX_NOT_USED error, since xy_idx is explicitly ignored.
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

MergeTree familyのテーブルで使用できます。

ignore_drop_queries_probability

型
Float
デフォルト値
0
バージョン履歴
バージョンデフォルト値コメント
24.40テスト目的で、指定した確率でサーバー上の drop クエリを無視できるようにします

有効にすると、サーバーは指定した確率ですべての DROP table クエリを無視します (Memory および JOIN エンジンでは、DROP を TRUNCATE に置き換えます) 。テスト目的で使用します

ignore_format_null_for_explain

型
Bool
デフォルト値
1
バージョン履歴
バージョンデフォルト値コメント
26.21EXPLAIN クエリでは、デフォルトで FORMAT Null が無視されるようになりました

有効な場合、EXPLAIN クエリでは FORMAT Null は無視され、代わりにデフォルトの出力フォーマットが使用されます。 無効な場合、FORMAT Null を指定した EXPLAIN クエリでは何も出力されません (後方互換性のある動作) 。

ignore_materialized_views_with_dropped_target_table

型
Bool
デフォルト値
0
バージョン履歴
バージョンデフォルト値コメント
24.10ターゲットテーブルが削除された materialized view を無視できる新しい設定を追加

ビューへのプッシュ時に、ターゲットテーブルが削除された MV を無視します

Navigation