すべてのプロダクト
Search
ドキュメントセンター

Time Series Database:LIMIT 句と SLIMIT 句

最終更新日:Jan 14, 2025

LIMIT 句はクエリごとに返されるポイント数を制限し、SLIMIT 句はクエリごとに返される系列数を制限します。

LIMIT 句

LIMIT <N> 句は、指定されたメジャーメントから最初の N 個のポイントを返します。

構文

SELECT_clause [INTO_clause] FROM_clause [WHERE_clause] [GROUP_BY_clause] [ORDER_BY_clause] LIMIT <N>

説明

N は、指定されたメジャーメントから返すポイント数を指定します。 N がメジャーメント内のポイントの総数よりも大きい場合、TSDB for InfluxDB® はメジャーメント内のすべてのポイントを返します。 LIMIT 句は、上記の構文で指定された順序で配置する必要があることに注意してください。

返されるポイント数を制限する

> SELECT "water_level","location" FROM "h2o_feet" LIMIT 3

name: h2o_feet
time                   water_level   location
----                   -----------   --------
2015-08-18T00:00:00Z   8.12          coyote_creek
2015-08-18T00:00:00Z   2.064         santa_monica
2015-08-18T00:06:00Z   8.005         coyote_creek

このクエリは、h2o_feet メジャーメントから最も古い 3 つのポイントを返します。最も古い 3 つのポイントは、タイムスタンプに基づいて決定されます。

返されるポイント数を制限し、GROUP BY 句を含める

> SELECT MEAN("water_level") FROM "h2o_feet" WHERE time >= '2015-08-18T00:00:00Z' AND time <= '2015-08-18T00:42:00Z' GROUP BY *,time(12m) LIMIT 2

name: h2o_feet
tags: location=coyote_creek
time                   mean
----                   ----
2015-08-18T00:00:00Z   8.0625
2015-08-18T00:12:00Z   7.8245

name: h2o_feet
tags: location=santa_monica
time                   mean
----                   ----
2015-08-18T00:00:00Z   2.09
2015-08-18T00:12:00Z   2.077

このクエリは、InfluxQL 関数と GROUP BY 句を使用します。このクエリは、クエリで指定された時間範囲内にある各 12 分間隔の各タグ値について、water_level フィールドキーの平均フィールド値を返します。 LIMIT 2 は、クエリが指定された時間範囲内で最も古い 2 つの 12 分間隔の water_level フィールドキーの平均フィールド値を要求していることを示します。最も古い 2 つの 12 分間隔は、タイムスタンプに基づいて決定されます。

注: 上記のステートメントに LIMIT 2 句が含まれていない場合、クエリは系列ごとに 4 つのポイントを返します。指定された時間範囲内の 12 分間隔ごとに 1 つのポイントが返されます。

SLIMIT 句

SLIMIT<N> 句は、指定されたメジャーメントの最初の N 系列から各ポイントを返します。

構文

SELECT_clause [INTO_clause] FROM_clause [WHERE_clause] GROUP BY *[,time(<time_interval>)] [ORDER_BY_clause] SLIMIT <N>

説明

N は、指定されたメジャーメントから返す系列数を指定します。 N がメジャーメント内の系列の総数よりも大きい場合、TSDB for InfluxDB® はメジャーメント内のすべての系列を返します。 SLIMIT 句は、上記の構文で指定された順序で配置する必要があることに注意してください。

返される系列数を制限する

> SELECT "water_level" FROM "h2o_feet" GROUP BY * SLIMIT 1

name: h2o_feet
tags: location=coyote_creek
time                   water_level
----                   -----
2015-08-18T00:00:00Z   8.12
2015-08-18T00:06:00Z   8.005
2015-08-18T00:12:00Z   7.887
[...]
2015-09-18T16:12:00Z   3.402
2015-09-18T16:18:00Z   3.314
2015-09-18T16:24:00Z   3.235

このクエリは、h2o_feet メジャーメントに関連付けられている系列の 1 つからすべての water_level ポイントを返します。

返される系列数を制限し、GROUP BY time() 句を含める

> SELECT MEAN("water_level") FROM "h2o_feet" WHERE time >= '2015-08-18T00:00:00Z' AND time <= '2015-08-18T00:42:00Z' GROUP BY *,time(12m) SLIMIT 1

name: h2o_feet
tags: location=coyote_creek
time                   mean
----                   ----
2015-08-18T00:00:00Z   8.0625
2015-08-18T00:12:00Z   7.8245
2015-08-18T00:24:00Z   7.5675
2015-08-18T00:36:00Z   7.303

このクエリは、InfluxQL 関数と GROUP BY 句で指定された時間間隔を使用して、指定された時間範囲内の各 12 分間隔の water_level フィールドキーの平均フィールド値を計算します。 SLIMIT 1 句は、クエリが h2o_feet メジャーメントに関連付けられている単一の系列を要求していることを指定します。

注: 上記のステートメントに SLIMIT 1 句が含まれていない場合、クエリは h2o_feet メジャーメントに関連付けられている次の 2 つの系列、location=coyote_creeklocation=santa_monica を返します。

LIMIT 句と SLIMIT 句

クエリの LIMIT <N> 句の後に SLIMIT <N> 句が表示される場合、クエリは指定されたメジャーメントの N 系列から最初の N 個のポイントを返します。

構文

SELECT_clause [INTO_clause] FROM_clause [WHERE_clause] GROUP BY *[,time(<time_interval>)] [ORDER_BY_clause] LIMIT <N1> SLIMIT <N2>

説明

N1 は、指定されたメジャーメントから返すポイント数を指定します。 N1 がメジャーメント内のポイントの総数よりも大きい場合、TSDB for InfluxDB® はメジャーメント内のすべてのポイントを返します。

N2 は、指定されたメジャーメントから返す系列数を指定します。 N2 がメジャーメント内の系列の総数よりも大きい場合、TSDB for InfluxDB® はメジャーメント内のすべての系列を返します。

LIMIT 句と SLIMIT 句は、上記の構文で指定された順序で配置する必要があることに注意してください。

返されるポイント数と系列数を制限する

> SELECT "water_level" FROM "h2o_feet" GROUP BY * LIMIT 3 SLIMIT 1

name: h2o_feet
tags: location=coyote_creek
time                   water_level
----                   -----------
2015-08-18T00:00:00Z   8.12
2015-08-18T00:06:00Z   8.005
2015-08-18T00:12:00Z   7.887

このクエリは、h2o_feet メジャーメントに関連付けられている系列の 1 つから最も古い 3 つのポイントを返します。

返されるポイント数と系列数を制限し、GROUP BY time() 句を含める

> SELECT MEAN("water_level") FROM "h2o_feet" WHERE time >= '2015-08-18T00:00:00Z' AND time <= '2015-08-18T00:42:00Z' GROUP BY *,time(12m) LIMIT 2 SLIMIT 1

name: h2o_feet
tags: location=coyote_creek
time                   mean
----                   ----
2015-08-18T00:00:00Z   8.0625
2015-08-18T00:12:00Z   7.8245

このクエリは、InfluxQL 関数と GROUP BY 句で指定された時間間隔を使用して、指定された時間範囲内の各 12 分間隔の water_level フィールドキーの平均フィールド値を計算します。 LIMIT 2 句は、クエリが指定された時間範囲内で最も古い 2 つの 12 分間隔の water_level フィールドキーの平均フィールド値を要求していることを指定します。最も古い 2 つの 12 分間隔は、タイムスタンプに基づいて決定されます。 SLIMIT 1 句は、クエリが h2o_feet メジャーメントに関連付けられている単一の系列を要求していることを指定します。

注: 上記のステートメントに LIMIT 2 SLIMIT 1 が含まれていない場合、クエリは h2o_feet メジャーメントに関連付けられている 2 つの系列ごとに 4 つのポイントを返します。

InfluxDB® は InfluxData によって登録された商標であり、TSDB for InfluxDB® とは提携しておらず、TSDB for InfluxDB® を推奨していません。