Back to Influxdb

Union

content/shared/sql-reference/union.md

latest4.5 KB
Original Source

The UNION clause combines the results of two or more SELECT statements into a single result set. By default, UNION only keeps unique rows. To keep all rows, including duplicates, use UNION ALL.

When using the UNION clause:

  • The number of columns in each result set must be the same.
  • Columns must be in the same order and of the same or compatible data types.

Syntax

sql
SELECT expression[,...n]
FROM measurement_1
UNION [ALL]
SELECT expression[,...n]
FROM measurement_2

Examples

Union results from different measurements

sql
(
  SELECT
    'h2o_pH' AS measurement,
    time,
    "pH" AS "water_pH"
  FROM "h2o_pH"
  LIMIT 4
)
UNION
(
  SELECT
    'h2o_quality' AS measurement,
    time,
    index
  FROM h2o_quality
  LIMIT 4
)

{{< expand-wrapper >}} {{% expand "View example results" %}}

measurementtimewater_pH
h2o_pH2019-08-27T00:12:00Z7
h2o_pH2019-08-27T00:18:00Z8
h2o_quality2019-09-11T01:06:00Z89
h2o_pH2019-08-27T00:06:00Z7
h2o_quality2019-09-11T00:00:00Z26
h2o_quality2019-09-11T01:00:00Z19
h2o_quality2019-09-11T00:48:00Z65
h2o_pH2019-08-27T00:00:00Z8

{{% /expand %}} {{< /expand-wrapper >}}

Return the highest and lowest three results in a single result set

The following example uses the sample data set provided in Get started with InfluxDB tutorial.

sql
(
  SELECT
    'low' as type,
    time,
    co
  FROM home
  ORDER BY co ASC
  LIMIT 3
)
UNION 
(
  SELECT
    'high' as type,
    time,
    co
  FROM home
  ORDER BY co DESC
  LIMIT 3
)

{{< expand-wrapper >}} {{% expand "View example results" %}}

typetimeco
high2022-01-01T20:00:00Z26
high2022-01-01T19:00:00Z22
high2022-01-01T18:00:00Z18
low2022-01-01T14:00:00Z0
low2022-01-01T10:00:00Z0
low2022-01-01T08:00:00Z0

{{% /expand %}} {{< /expand-wrapper >}}

Union query results with custom data

The following example uses the sample data set provided in Get started with InfluxDB tutorial. It also uses the table value constructor to build a table with custom data.

sql
SELECT *
FROM home
WHERE
  time >= '2022-01-01T08:00:00Z'
  AND time <= '2022-01-01T12:00:00Z'
UNION
SELECT * FROM
  (VALUES (0, 34.2, 'Bedroom', 21.1, '2022-01-01T08:00:00Z'::TIMESTAMP),
          (0, 34.5, 'Bedroom', 21.2, '2022-01-01T09:00:00Z'::TIMESTAMP),
          (0, 34.6, 'Bedroom', 21.5, '2022-01-01T10:00:00Z'::TIMESTAMP),
          (0, 34.5, 'Bedroom', 21.8, '2022-01-01T11:00:00Z'::TIMESTAMP),
          (0, 33.9, 'Bedroom', 22.0, '2022-01-01T12:00:00Z'::TIMESTAMP)
  ) newRoom(co, hum, room, temp, time)
ORDER BY room, time

{{< expand-wrapper >}} {{% expand "View example results" %}}

cohumroomtemptime
034.2Bedroom21.12022-01-01T08:00:00Z
034.5Bedroom21.22022-01-01T09:00:00Z
034.6Bedroom21.52022-01-01T10:00:00Z
034.5Bedroom21.82022-01-01T11:00:00Z
033.9Bedroom222022-01-01T12:00:00Z
035.9Kitchen212022-01-01T08:00:00Z
036.2Kitchen232022-01-01T09:00:00Z
036.1Kitchen22.72022-01-01T10:00:00Z
036Kitchen22.42022-01-01T11:00:00Z
036Kitchen22.52022-01-01T12:00:00Z
035.9Living Room21.12022-01-01T08:00:00Z
035.9Living Room21.42022-01-01T09:00:00Z
036Living Room21.82022-01-01T10:00:00Z
036Living Room22.22022-01-01T11:00:00Z
035.9Living Room22.22022-01-01T12:00:00Z

{{% /expand %}} {{< /expand-wrapper >}}