docs-v2/content/v2.0/reference/flux/functions/built-in/inputs/fromcsv.md

title	description	aliases	menu	weight
fromCSV() function	The fromCSV() function retrieves data from a CSV data source.	/v2.0/reference/flux/functions/inputs/fromcsv	v2_0_ref name parent fromCSV built-in-inputs	401

The fromCSV() function retrieves data from a comma-separated value (CSV) data source. It returns a stream of tables. Each unique series is contained within its own table. Each record in the table represents a single point in the series.

Function type: Input
Output data type: Object

from(file: "/path/to/data-file.csv")

// OR

from(csv: csvData)

Parameters

file

The file path of the CSV file to query. The path can be absolute or relative. If relative, it is relative to the working directory of the influxd process.

Data type: String

csv

Raw CSV-formatted text.

{{% note %}} CSV data must be in the CSV format produced by the Flux HTTP response standard. See the Flux technical specification for information about this format. {{% /note %}}

Data type: String

Examples

Query CSV data from a file

from(file: "/path/to/data-file.csv")

Query raw CSV-formatted text

csvData = "
result,table,_start,_stop,_time,region,host,_value
mean,0,2018-05-08T20:50:00Z,2018-05-08T20:51:00Z,2018-05-08T20:50:00Z,east,A,15.43
mean,0,2018-05-08T20:50:00Z,2018-05-08T20:51:00Z,2018-05-08T20:50:20Z,east,B,59.25
mean,0,2018-05-08T20:50:00Z,2018-05-08T20:51:00Z,2018-05-08T20:50:40Z,east,C,52.62
"

from(csv: csvData)