Skip to main content
Version: v4.23

unflatten

Unflattens nested data.

unflatten(x:record, [sep=string]) -> record

Description​

The unflatten function creates nested records out of fields whose names include a separator.

info

unflatten uses a heuristic to determine the unflattened schema. Thus, the schema of a record that has been flattened using flatten and unflattened afterwards may not be identical to the schema of the unmodified record.

sep = string (optional)​

The separator to use for splitting field names.

Defaults to ".".

Examples​

Unflatten fields at the dot character​

// Note the fields in double quotes that are single fields that contain a
// literal "." in their field name, as opposed to nested records.
from {
  src_ip: 147.32.84.165,
  src_port: 1141,
  dest_ip: 147.32.80.9,
  dest_port: 53,
  event_type: "dns",
  "dns.type": "query",
  "dns.id": 553,
  "dns.rrname": "irc.freenode.net",
  "dns.rrtype": "A",
  "dns.tx_id": 0,
  "dns.grouped.A": ["tenzir.com"],
}
this = unflatten(this)
{
  src_ip: 147.32.84.165,
  src_port: 1141,
  dest_ip: 147.32.80.9,
  dest_port: 53,
  event_type: "dns",
  dns: {
    type: "query",
    id: 553,
    rrname: "irc.freenode.net",
    rrtype: "A",
    tx_id: 0,
    grouped: {
      A: [
        "tenzir.com",
      ],
    },
  },
}

See Also​

flatten