メインコンテンツまでスキップ
メインコンテンツまでスキップ

PREWHERE 句

Prewhere はフィルタリングをより効率的に適用するための最適化です。PREWHERE 句が明示的に指定されていなくても、デフォルトで有効になっています。これは、WHERE 条件の一部を自動的に Prewhere ステージに移動することによって機能します。PREWHERE 句の役割は、この最適化を制御することであり、デフォルトの動作よりも良い方法を知っていると考える場合に使用します。

Prewhere 最適化では、最初に Prewhere 式を実行するために必要なカラムだけが読み取られます。その後、クエリの残りを実行するために必要な他のカラムが読み取られますが、Prewhere 式が少なくともいくつかの行に対して true であるブロックのみです。すべての行に対して Prewhere 式が false のブロックが多く、Prewhere がクエリの他の部分よりも少ないカラムを必要とする場合、これによりクエリ実行のためにディスクから読み取るデータ量を大幅に削減することができます。

Prewhere を手動で制御する

この句は WHERE 句と同じ意味を持ちます。違いは、どのデータがテーブルから読み取られるかです。クエリの中で少数のカラムによって使用されるフィルタ条件のために PREWHERE を手動で制御することができますが、それは強力なデータフィルタリングを提供します。これにより、読み取るデータの量が減少します。

クエリは同時に PREWHEREWHERE を指定することができます。この場合、PREWHEREWHERE に先行します。

optimize_move_to_prewhere 設定が 0 に設定されている場合、WHERE から PREWHERE に自動的に式の一部を移動するためのヒューリスティックは無効化されます。

クエリに FINAL 修飾子がある場合、PREWHERE の最適化は常に正しいわけではありません。これは、optimize_move_to_prewhereoptimize_move_to_prewhere_if_final の両方が有効な場合のみ有効になります。

注記

PREWHERE セクションは FINAL の前に実行されるため、ORDER BY セクションに含まれないフィールドで PREWHERE を使用すると、FROM ... FINAL クエリの結果が歪む可能性があります。

制限事項

PREWHERE*MergeTree ファミリーのテーブルでのみサポートされています。