Migrate continuous queries to tasks

This page documents an earlier version of InfluxDB. InfluxDB v2.7 is the latest stable version. View this page in the v2.7 documentation.

InfluxDB OSS 2.3 replaces 1.x continuous queries (CQs) with InfluxDB tasks. To migrate continuous queries to InfluxDB 2.3 tasks, do the following:

  1. Output all InfluxDB 1.x continuous queries
  2. Convert continuous queries to Flux queries
  3. Create new InfluxDB tasks

Output all InfluxDB 1.x continuous queries

If using the influxd upgrade command, by default, all continuous queries are output to ~/continuous_queries.txt during the upgrade process. To customize the destination path of the continuous queries file, use the --continuous-query-export-path flag with the influxd upgrade command.

  1. influxd upgrade --continuous-query-export-path /path/to/continuous_queries.txt

To manually output continuous queries:

  1. Use the InfluxDB 1.x influx interactive shell to run SHOW CONTINUOUS QUERIES:

    1. $ influx
    2. Connected to http://localhost:8086 version 1.8.10
    3. InfluxDB shell version: 1.8.10
    4. > SHOW CONTINUOUS QUERIES

  2. Copy and save the displayed continuous queries.

Convert continuous queries to Flux queries

To migrate InfluxDB 1.x continuous queries to InfluxDB 2.3 tasks, convert the InfluxQL query syntax to Flux. The majority of continuous queries are simple downsampling queries and can be converted quickly using the aggregateWindow() function. For example:

Example continuous query
  1. CREATE CONTINUOUS QUERY "downsample-daily" ON "my-db"
  2. BEGIN
  3.   SELECT mean("example-field")
  4.   INTO "my-db"."example-rp"."average-example-measurement"
  5.   FROM "example-measurement"
  6.   GROUP BY time(1h)
  7. END
Equivalent Flux task
  1. option task = {name: "downsample-daily", every: 1d}
  3. from(bucket: "my-db/")
  4.     |> range(start: -task.every)
  5.     |> filter(fn: (r) => r._measurement == "example-measurement")
  6.     |> filter(fn: (r) => r._field == "example-field")
  7.     |> aggregateWindow(every: 1h, fn: mean)
  8.     |> set(key: "_measurement", value: "average-example-measurement")
  9.     |> to(org: "example-org", bucket: "my-db/example-rp")

Convert InfluxQL continuous queries to Flux

Review the following statements and clauses to see how to convert your CQs to Flux:

ON clause

The ON clause defines the database to query. In InfluxDB OSS 2.3, database and retention policy combinations are mapped to specific buckets (for more information, see Database and retention policy mapping).

Use the from() function to specify the bucket to query:

InfluxQL
  1. CREATE CONTINUOUS QUERY "downsample-daily" ON "my-db"
  2. -- ...
Flux
  1. from(bucket: "my-db/")
  2. // ...

SELECT statement

The SELECT statement queries data by field, tag, and time from a specific measurement. SELECT statements can take many different forms and converting them to Flux depends on your use case. For information about Flux and InfluxQL function parity, see Flux vs InfluxQL. See other resources available to help.

INTO clause

The INTO clause defines the measurement to write results to. INTO also supports fully-qualified measurements that include the database and retention policy. In InfluxDB OSS 2.3, database and retention policy combinations are mapped to specific buckets (for more information, see Database and retention policy mapping).

To write to a measurement different than the measurement queried, use set() or map() to change the measurement name. Use the to() function to specify the bucket to write results to.

InfluxQL
  1. -- ...
  2. INTO "example-db"."example-rp"."example-measurement"
  3. -- ...
Flux

set() map()

  1. // ...
  2.     |> set(key: "_measurement", value: "example-measurement")
  3.     |> to(bucket: "example-db/example-rp")
  1. // ...
  2.     |> map(fn: (r) => ({ r with _measurement: "example-measurement"}))
  3.     |> to(bucket: "example-db/example-rp")
Write pivoted data to InfluxDB

InfluxDB 1.x query results include a column for each field. InfluxDB 2.3 does not do this by default, but it is possible with pivot() or schema.fieldsAsCols().

If you use to() to write pivoted data back to InfluxDB 2.3, each field column is stored as a tag. To write pivoted fields back to InfluxDB as fields, import the experimental package and use the experimental.to() function.

InfluxQL
  1. CREATE CONTINUOUS QUERY "downsample-daily" ON "my-db"
  2. BEGIN
  3.   SELECT mean("example-field-1"), mean("example-field-2")
  4.   INTO "example-db"."example-rp"."example-measurement"
  5.   FROM "example-measurement"
  6.   GROUP BY time(1h)
  7. END
Flux
  1. // ...
  3. from(bucket: "my-db/")
  4.     |> range(start: -task.every)
  5.     |> filter(fn: (r) => r._measurement == "example-measurement")
  6.     |> filter(fn: (r) => r._field == "example-field-1" or r._field == "example-field-2")
  7.     |> aggregateWindow(every: task.every, fn: mean)
  8.     |> pivot(rowKey:["_time"], columnKey: ["_field"], valueColumn: "_value")
  9.     |> experimental.to(bucket: "example-db/example-rp")

FROM clause

The from clause defines the measurement to query. Use the filter() function to specify the measurement to query.

InfluxQL
  1. -- ...
  2. FROM "example-measurement"
  3. -- ...
Flux
  1. // ...
  2.     |> filter(fn: (r) => r._measurement == "example-measurement")

AS clause

The AS clause changes the name of the field when writing data back to InfluxDB. Use set() or map() to change the field name.

InfluxQL
  1. -- ...
  2. AS newfield
  3. -- ...
Flux

set() map()

  1. // ...
  2.     |> set(key: "_field", value: "newfield")
  1. // ...
  2.     |> map(fn: (r) => ({ r with _field: "newfield"}))

WHERE clause

The WHERE clause uses predicate logic to filter results based on fields, tags, or timestamps. Use the filter() function and Flux comparison operators to filter results based on fields and tags. Use the range() function to filter results based on timestamps.

InfluxQL
  1. -- ...
  2. WHERE "example-tag" = "foo" AND time > now() - 7d
Flux
  1. // ...
  2.     |> range(start: -7d)
  3.     |> filter(fn: (r) => r["example-tag"] == "foo")

GROUP BY clause

The InfluxQL GROUP BY clause groups data by specific tags or by time (typically to calculate an aggregate value for windows of time).

Group by tags

Use the group() function to modify the group key and change how data is grouped.

InfluxQL
  1. -- ...
  2. GROUP BY "location"
Flux
  1. // ...
  2.     |> group(columns: ["location"])
Group by time

Use the aggregateWindow() function to group data into time windows and perform an aggregation on each window. In CQs, the interval specified in the GROUP BY time() clause determines the CQ execution interval. Use the GROUP BY time() interval to set the every task option.

InfluxQL
  1. -- ...
  2. SELECT MEAN("example-field")
  3. FROM "example-measurement"
  4. GROUP BY time(1h)
Flux
  1. option task = {name: "task-name", every: 1h}
  3. // ...
  4.     |> filter(fn: (r) => r._measurement == "example-measurement" and r._field == "example-field")
  5.     |> aggregateWindow(every: task.every, fn: mean)

RESAMPLE clause

The CQ RESAMPLE clause uses data from the last specified duration to calculate a new aggregate point. The EVERY interval in RESAMPLE defines how often the CQ runs. The FOR interval defines the total time range queried by the CQ.

To accomplish this same functionality in a Flux task, set the start parameter in the range() function to the negative FOR duration. Define the task execution interval in the task options. For example:

InfluxQL
  1. CREATE CONTINUOUS QUERY "resample-example" ON "my-db"
  2. RESAMPLE EVERY 1m FOR 30m
  3. BEGIN
  4.   SELECT exponential_moving_average(mean("example-field"), 30)
  5.   INTO "resample-average-example-measurement"
  6.   FROM "example-measurement"
  7.   WHERE region = 'example-region'
  8.   GROUP BY time(1m)
  9. END
Flux
  1. option task = {name: "resample-example", every: 1m}
  3. from(bucket: "my-db/")
  4.     |> range(start: -30m)
  5.     |> filter(fn: (r) => r._measurement == "example-measurement" and r._field == "example-field" and r.region == "example-region")
  6.     |> aggregateWindow(every: 1m, fn: mean)
  7.     |> exponentialMovingAverage(n: 30)
  8.     |> set(key: "_measurement", value: "resample-average-example-measurement")
  9.     |> to(bucket: "my-db/")

Create new InfluxDB tasks

After converting your continuous query to Flux, use the Flux query to create a new task.

Other helpful resources

The following resources are available and may be helpful when converting continuous queries to Flux tasks.

Documentation
Community