处理记录
提示
记录大致相当于表格中的单独一行。你可以把记录看作是一个“单行表格”。因此,大多数对表格行操作的命令同样适用于记录。例如,update 可以用于记录:
let my_record = {
name: "Sam"
age: 30
}
$my_record | update age { $in + 1 }
# => ╭──────┬─────╮
# => │ name │ Sam │
# => │ age │ 31 │
# => ╰──────┴─────╯请注意,my_record 变量是不可变的。管道产生的更新后的记录会像代码块中显示的那样被打印出来。my_record 变量仍然保存着原始值——$my_record.age 仍然是 30。
创建记录
记录是零个或多个键值对映射的集合。它类似于 JSON 对象,并且可以用相同的语法创建:
# Nushell
{ "apples": 543, "bananas": 411, "oranges": 0 }
# => ╭─────────┬─────╮
# => │ apples │ 543 │
# => │ bananas │ 411 │
# => │ oranges │ 0 │
# => ╰─────────┴─────╯
# JSON
'{ "apples": 543, "bananas": 411, "oranges": 0 }' | from json
# => ╭─────────┬─────╮
# => │ apples │ 543 │
# => │ bananas │ 411 │
# => │ oranges │ 0 │
# => ╰─────────┴─────╯在 Nushell 中,记录的键值对也可以用空格或换行来分隔。
提示
由于记录可能有多个字段,默认情况下它们是纵向显示而不是横向显示。要让记录横向显示,请把它转换为 nuon。例如:
{
name: "Sam"
rank: 10
} | to nuon
# => {name: Sam, rank: 10}更新记录
与列表一样,你可以在记录中 insert 值。例如,我们来添加一些梨:
{ "apples": 543, "bananas": 411, "oranges": 0 }
| insert pears { 21 }
# => ╭─────────┬─────╮
# => │ apples │ 543 │
# => │ bananas │ 411 │
# => │ oranges │ 0 │
# => │ pears │ 21 │
# => ╰─────────┴─────╯你也可以 update 值:
{ "apples": 543, "bananas": 411, "oranges": 0 }
| update oranges { 100 }
# => ╭─────────┬─────╮
# => │ apples │ 543 │
# => │ bananas │ 411 │
# => │ oranges │ 100 │
# => ╰─────────┴─────╯要创建一个带有新字段的记录副本,你可以:
使用
merge命令:let first_record = { name: "Sam", rank: 10 } $first_record | merge { title: "Mayor" } # => ╭───────┬───────╮ # => │ name │ Sam │ # => │ rank │ 10 │ # => │ title │ Mayor │ # => ╰───────┴───────╯使用展开运算符(
...)在新记录中展开第一个记录:let first_record = { name: "Sam", rank: 10 } { ...$first_record title: "Mayor" } # => ╭───────┬───────╮ # => │ name │ Sam │ # => │ rank │ 10 │ # => │ title │ Mayor │ # => ╰───────┴───────╯
遍历记录
使用 items 命令遍历每一对键值:
{ "apples": 543, "bananas": 411, "oranges": 0 } | items {|fruit, count| $"We have ($fruit) ($count)" }
# => ╭───┬─────────────────────╮
# => │ 0 │ We have apples 543 │
# => │ 1 │ We have bananas 411 │
# => │ 2 │ We have oranges 0 │
# => ╰───┴─────────────────────╯或者,你也可以先用 transpose 把记录转置成带列的表格,再逐行遍历:
{ "apples": 543, "bananas": 411, "oranges": 0 }
| transpose fruit count
| each {|f| $"We have ($f.count) ($f.fruit)" }
# => ╭───┬─────────────────────╮
# => │ 0 │ We have 543 apples │
# => │ 1 │ We have 411 bananas │
# => │ 2 │ We have 0 oranges │
# => ╰───┴─────────────────────╯转换记录
record 系列命令接收一个记录并返回一个记录,所以你不需要先把它 transpose 成表格再转回来,也不需要用 items 配合 into record 重新构建。它们每一个也都接受表格,并对每一行生效。
record where 保留 key 和 value 满足行条件的字段:
{ "apples": 543, "bananas": 411, "oranges": 0 } | record where value > 0
# => ╭─────────┬─────╮
# => │ apples │ 543 │
# => │ bananas │ 411 │
# => ╰─────────┴─────╯
{ "apples": 543, "bananas": 411, "oranges": 0 } | record where key starts-with b
# => ╭─────────┬─────╮
# => │ bananas │ 411 │
# => ╰─────────┴─────╯它也接受一个闭包,闭包接收键和值作为参数。若在条件之前加上 --keys 或 --values,闭包就只接收其中之一:
{ "apples": 543, "bananas": 411, "oranges": 0 } | record where --values {|count| $count > 500 }
# => ╭────────┬─────╮
# => │ apples │ 543 │
# => ╰────────┴─────╯record each 根据闭包返回的记录构造一个新记录,因此可以在一次处理中同时改变键和值:
{ "apples": 543, "bananas": 411, "oranges": 0 }
| record each {|fruit, count| {($fruit | str uppercase): ($count * 2)} }
# => ╭─────────┬──────╮
# => │ APPLES │ 1086 │
# => │ BANANAS │ 822 │
# => │ ORANGES │ 0 │
# => ╰─────────┴──────╯record walk 对嵌套在记录中任意位置的每个值运行闭包,并把结果放回原来的位置。闭包接收值和它的单元格路径。例如,隐藏配置记录中的每一处敏感值:
{db: {host: prod, password: hunter2}, api: {token: abc}}
| record walk {|value, path|
if ($path | to text) =~ "(?i)secret|token|password" { "***" } else { $value }
}
| to nuon
# => {db: {host: prod, password: ***}, api: {token: ***}}默认情况下只访问叶子节点。--containers 还会把嵌套的记录和列表也传给闭包,而 --no-lists 会把列表当作单个值,不再深入遍历。
record apply 接收一个由闭包组成的记录,并让每个闭包作用于同名的字段。没有对应闭包的字段保持原样:
{age: "42", email: "A@B.COM", tags: [x]} | record apply {age: {into int}, email: {str lowercase}}
# => ╭───────┬───────────────╮
# => │ age │ 42 │
# => │ email │ a@b.com │
# => │ tags │ [list 1 item] │
# => ╰───────┴───────────────╯由于表格就是记录的列表,同一份闭包记录也能转换每一行中的某一列:
[{name: a, size: "1"} {name: b, size: "2"}] | record apply {size: {into int}}
# => ╭───┬──────┬──────╮
# => │ # │ name │ size │
# => ├───┼──────┼──────┤
# => │ 0 │ a │ 1 │
# => │ 1 │ b │ 2 │
# => ╰───┴──────┴──────╯若某个字段的闭包在输入中没有对应的字段,该闭包会被忽略;除非传入 --strict,此时会报错。
访问记录值
关于如何访问记录值(以及其它结构化数据)的深入说明,请参阅导航与访问结构化数据。
其它记录命令
请参阅处理表格——请记住,对表格行操作的命令通常以相同的方式作用于记录。