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 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
)。