first()
The first aggregate allows you to get the value of one column as ordered by another. For example, first(temperature, time) returns the earliest temperature value based on time within an aggregate group.
important
The last and first commands do not use indexes, they perform a sequential scan through the group. They are primarily used for ordered selection within a GROUP BY aggregate, and not as an alternative to an ORDER BY time DESC LIMIT 1 clause to find the latest value, which uses indexes.
Required arguments
| Name | Type | Description |
|---|---|---|
value |
TEXT | The value to return |
time |
TIMESTAMP or INTEGER | The timestamp to use for comparison |
Sample usage
Get the earliest temperature by device_id:
2. SELECT device_id, first(temp, time)
4. FROM metrics
6. GROUP BY device_id;
This example uses first and last with an aggregate filter, and avoids null values in the output:
2. SELECT
4. TIME_BUCKET('5 MIN', time_column) AS interv,
6. AVG(temperature) as avg_temp,
8. first(temperature,time_column) FILTER(WHERE time_column IS NOT NULL) AS beg_temp,
10. last(temperature,time_column) FILTER(WHERE time_column IS NOT NULL) AS end_temp
12. FROM sensors
14. GROUP BY interv
