114 lines
3.4 KiB
Markdown
114 lines
3.4 KiB
Markdown
---
|
|
title: Create a task
|
|
seotitle: Create a task for processing data in InfluxDB
|
|
description: >
|
|
Create a data processing task in InfluxDB using the InfluxDB UI or the `influx` CLI.
|
|
menu:
|
|
v2_0:
|
|
name: Create a task
|
|
parent: Manage tasks
|
|
weight: 201
|
|
related:
|
|
- /v2.0/reference/cli/influx/task/create
|
|
---
|
|
|
|
InfluxDB provides multiple ways to create tasks both in the InfluxDB user interface (UI)
|
|
and the `influx` command line interface (CLI).
|
|
|
|
_Before creating a task, review the [basics criteria for writing a task](/v2.0/process-data/get-started)._
|
|
|
|
- [InfluxDB UI](#create-a-task-in-the-influxdb-ui)
|
|
- [`influx` CLI](#create-a-task-using-the-influx-cli)
|
|
|
|
## Create a task in the InfluxDB UI
|
|
The InfluxDB UI provides multiple ways to create a task:
|
|
|
|
- [Create a task from the Data Explorer](#create-a-task-from-the-data-explorer)
|
|
- [Create a task in the Task UI](#create-a-task-in-the-task-ui)
|
|
- [Import a task](#import-a-task)
|
|
- [Create a task from a template](#create-a-task-from-a-template)
|
|
- [Clone a task](#clone-a-task)
|
|
|
|
### Create a task from the Data Explorer
|
|
1. Click the **Data Explorer** icon in the left navigation menu.
|
|
|
|
{{< nav-icon "data-explorer" >}}
|
|
|
|
2. Building a query and click **Save As** in the upper right.
|
|
3. Select the **Task** option.
|
|
4. Specify the task options. See [Task options](/v2.0/process-data/task-options)
|
|
for detailed information about each option.
|
|
5. Select a token to use from the **Token** dropdown.
|
|
6. Click **Save as Task**.
|
|
|
|
|
|
### Create a task in the Task UI
|
|
1. Click the **Tasks** icon in the left navigation menu.
|
|
|
|
{{< nav-icon "tasks" >}}
|
|
|
|
2. Click **{{< icon "plus" >}} Create Task** in the upper right.
|
|
3. Select **New Task**.
|
|
4. In the left panel, specify the task options.
|
|
See [Task options](/v2.0/process-data/task-options) for detailed information about each option.
|
|
5. Select a token to use from the **Token** dropdown.
|
|
6. In the right panel, enter your task script.
|
|
7. Click **Save** in the upper right.
|
|
|
|
### Import a task
|
|
1. Click the **Tasks** icon in the left navigation menu.
|
|
|
|
{{< nav-icon "tasks" >}}
|
|
|
|
2. Click **+ Create Task** in the upper right.
|
|
3. Select **Import Task**.
|
|
4. Upload a JSON task file using one of the following options:
|
|
- Drag and drop a JSON task file in the specified area.
|
|
- Click to upload and the area to select the JSON task from from your file manager.
|
|
- Select the **JSON** option and paste in raw task JSON.
|
|
5. Click **Import JSON as Task**.
|
|
|
|
### Create a task from a template
|
|
1. Click the **Settings** icon in the left navigation menu.
|
|
|
|
{{< nav-icon "Settings" >}}
|
|
|
|
2. Select **Templates**.
|
|
3. Hover over the template to use to create the task and click **Create**.
|
|
|
|
|
|
### Clone a task
|
|
1. Click the **Tasks** icon in the left navigation menu.
|
|
|
|
{{< nav-icon "tasks" >}}
|
|
|
|
2. Hover over the task you would like to clone and click the **{{< icon "duplicate" >}}** icon that appears.
|
|
4. Click **Clone**.
|
|
|
|
## Create a task using the influx CLI
|
|
Use `influx task create` command to create a new task.
|
|
It accepts either a file path or raw Flux.
|
|
|
|
###### Create a task using a file
|
|
```sh
|
|
# Syntax
|
|
influx task create --org <org-name> @</path/to/task-script>
|
|
|
|
# Example
|
|
influx task create --org my-org @/tasks/cq-mean-1h.flux
|
|
```
|
|
|
|
###### Create a task using raw Flux
|
|
```sh
|
|
influx task create --org my-org - # <return> to open stdin pipe
|
|
|
|
options task = {
|
|
name: "task-name",
|
|
every: 6h
|
|
}
|
|
|
|
# ... Task script ...
|
|
|
|
# <ctrl-d> to close the pipe and submit the command
|
|
```
|