map() 函数
map() 遍历并对输入行应用一个函数。
每个输入行作为记录 r 传递给 fn。
每个 r 属性代表一个列的键值对。
输出值必须是以下支持的列类型:
- 浮点数
- 整数
- 无符号整数
- 字符串
- 布尔值
- 时间
输出数据
输出表是将map函数 (fn) 应用到输入表的每个记录的结果。输出记录根据输入流的组键分配到新的表中。如果输出记录包含组键列的不同值,则该记录被重新分组到适当的表中。如果输出记录丢弃了组键列,则该列将从组键中移除。
保留列
map() 丢弃任何未通过列标签明确映射或使用 with 操作符隐式映射的列。在 fn 函数中,with 操作符会更新已存在的记录属性,如果不存在则创建一个新的记录属性,并将所有现有属性包含在输出记录中。
data
|> map(fn: (r) => ({ r with newColumn: r._value * 2 }))
函数类型签名
(<-tables: stream[A], fn: (r: A) => B, ?mergeKey: bool) => stream[B]
有关更多信息,请参见 Function type signatures。
参数
函数
(必填) 用于对每条记录应用的单一参数函数。 返回值必须是一个记录。
合并键
(已弃用) 合并映射记录的组键。默认值为 false。
表格
输入数据。默认是管道转发数据 (<-).
示例
对每行的值进行平方
import "sampledata"
sampledata.int()
|> map(fn: (r) => ({r with _value: r._value * r._value}))
创建一个包含新列的新表
import "sampledata"
sampledata.int()
|> map(
fn: (r) => ({time: r._time, source: r.tag, alert: if r._value > 10 then true else false}),
)
添加新列并保留现有列
在r记录上使用with操作符,以保留未被map操作直接操作的列。
import "sampledata"
sampledata.int()
|> map(fn: (r) => ({r with server: "server-${r.tag}", valueFloat: float(v: r._value)}))