docs-v2/content/flux/v0/stdlib/array/from.md

2.1 KiB

title description menu weight flux/v0/tags
array.from() function `array.from()` constructs a table from an array of records.
flux_v0_ref
name parent identifier
array.from array array/from
101
inputs

array.from() constructs a table from an array of records.

Each record in the array is converted into an output row or record. All records must have the same keys and data types.

Function type signature
(<-rows: [A]) => stream[A] where A: Record

{{% caption %}} For more information, see Function type signatures. {{% /caption %}}

Parameters

rows

Array of records to construct a table with. Default is the piped-forward array (<-).

Examples

Build an arbitrary table

import "array"

rows = [{foo: "bar", baz: 21.2}, {foo: "bar", baz: 23.8}]

array.from(rows: rows)

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

Output data

foo baz
bar 21.2
bar 23.8

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

Union custom rows with query results

import "influxdata/influxdb/v1"
import "array"

tags = v1.tagValues(bucket: "example-bucket", tag: "host")

wildcard_tag = array.from(rows: [{_value: "*"}])

union(tables: [tags, wildcard_tag])