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

title	description	menu	weight	deprecated
array.from() function	`array.from()` constructs a table from an array of records.	flux_v0_ref name parent identifier array.from experimental/array experimental/array/from	201	0.103.0

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

{{% warn %}}

Deprecated

Experimental array.from() is deprecated in favor of array.from(). This function is available for backwards compatibility, but we recommend using the array package instead. {{% /warn %}}

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.

Examples

• Build an arbitrary table
• Union custom rows with query results

Build an arbitrary table

import "experimental/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 "experimental/array"

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

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

union(tables: [tags, wildcard_tag])