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

LIMIT BY 句

LIMIT n BY expressions 句を含むクエリは、各異なる expressions に対して最初の n 行を選択します。LIMIT BY のキーは、任意の数の expressions を含むことができます。

ClickHouse は以下の構文のバリアントをサポートしています:

  • LIMIT [offset_value, ]n BY expressions
  • LIMIT n OFFSET offset_value BY expressions

クエリ処理中、ClickHouse はソートキーによって順序付けられたデータを選択します。ソートキーは ORDER BY 句を使用して明示的に設定するか、テーブルエンジンのプロパティとして暗黙的に設定されます(ORDER BY を使用することでのみ行の順序が保証され、そうでない場合はマルチスレッドによるため行ブロックは順序付けされません)。その後、ClickHouse は LIMIT n BY expressions を適用し、各異なる expressions の組み合わせについて最初の n 行を返します。OFFSET が指定されている場合、各異なる expressions の組み合わせに属するデータブロックから、ClickHouse はブロックの先頭から offset_value 行をスキップし、最大で n 行を結果として返します。もし offset_value がデータブロック内の行数よりも大きい場合、ClickHouse はブロックからゼロ行を返します。

注記

LIMIT BYLIMIT とは関連していません。両方とも同じクエリ内で使用できます。

LIMIT BY 句で列名の代わりに列番号を使用する場合は、設定 enable_positional_arguments を有効にしてください。

サンプルテーブル:

クエリ:

SELECT * FROM limit_by ORDER BY id, val LIMIT 2 OFFSET 1 BY id クエリは同じ結果を返します。

次のクエリは、合計で最大 100 行の各 domain, device_type ペアの上位 5 件のリファラーを返します (LIMIT n BY + LIMIT)。