Order By

Use the ORDER BY clause to sort data by time in ascending or descending order. InfluxQL only supports sorting data by time.

• Syntax
• Examples

Syntax

SELECT_clause FROM_clause [WHERE_clause] [GROUP_BY_clause] ORDER BY time [ASC|DESC]

• If the the ORDER BY clause is not included, the default behavior is to sort data by time in ascending order: ORDER BY time ASC.
• If the query includes WHERE and GROUP BY clauses, the ORDER BY clause must come after these clauses.

Sort orders

• ASC (ascending): The first row in the results has the oldest timestamp. The last row in the results has the most recent timestamp.
• DESC (descending): The first row in the results has the most recent timestamp. The last row in the results has the oldest timestamp.

Examples

The following examples use the Home sensor sample data.

{{< expand-wrapper >}}

{{% expand "Sort data with the oldest points first" %}}

[!Tip] Ordering data by time in ascending order is the default behavior. Including ORDER BY time ASC in the query isn't necessary, but it is supported.

{{% influxdb/custom-timestamps %}}

SELECT *
FROM home
WHERE
  room = 'Kitchen'
  AND time >= '2022-01-01T08:00:00Z'
  AND time <= '2022-01-01T12:00:00Z'
ORDER BY time ASC

{{% influxql/table-meta %}} Name: home {{% /influxql/table-meta %}}

{{% /influxdb/custom-timestamps %}} {{% /expand %}}

{{% expand "Sort data with the newest points first" %}}

{{% influxdb/custom-timestamps %}}

SELECT *
FROM home
WHERE
  room = 'Kitchen'
  AND time >= '2022-01-01T08:00:00Z'
  AND time <= '2022-01-01T12:00:00Z'
ORDER BY time DESC

{{% /influxdb/custom-timestamps %}} {{% /expand %}}

{{< /expand-wrapper >}}