Nest Your Data

In Designer Cloud, you can nest columns into arrays and objects (maps) using a variety of transformations.

Nested data types include the following types of data:

Arrays are lists of values, grouped into a single value. Examples:
```
[1,2,3,4]
```
```
[1,2,[a,b],4]
```

Objects are collections of key-value pairs. Examples:

{"make":"Subaru","model":"Outback","year":"2015","color":"black"}

{"make":"Subaru","model":"Outback","year":{"first":"2015","last":"2021"},"color":"black"}

In the above examples:

The first example is a flat or unnested Array or Object.
The first example is a nested Array or Object.

Nest Columns into Array

This section provides simple examples of nesting columns into Arrays by extracting values from a column or nesting one or more columns into an Array column.

Create by extraction:

You can create an array of values by extracting pattern-based values from a specified column. The following transformation extracts from the msg column a list of all values where all letters are capitalized and places them into the new acronyms column:

Transformation Name	`Extract matches into Array`
Parameter: Column	msg
Parameter: Pattern matching elements in the list	`{upper}+`
Parameter: New column name	acronyms

msg	acronyms
SCUBA, IMHO, is the greatest sport in the world.	["SCUBA","IMHO"]
	[]
LOL, that assignment you finished is DOA. You need to fix it PDQ.	["LOL","DOA","Y","PDQ"]

Notes:

An empty input column value renders an empty array.
In the final row, the Wrangle matches on the "Y" value. To fix this, you can change the Pattern matching value to the following, which matches on two or more uppercase letters in a row:
```
`{upper}{upper}+`
```

Create by nesting:

You can create arrays by nesting together the values from multiple columns:

num1	num2	num3
11	12	13
14	15	16
17	18	19

You can nest the values in num1 and num2 into a single array and then to nest the array with num3:

注意

If you are nesting a multi-level array, you should nest from the lowest level to the top level.

Transformation Name	`Nest columns into Objects`
Parameter: Columns1	num1
Parameter: Columns2	num2
Parameter: Nest columns to	Array
Parameter: New column name	nest1

Then, you can perform the nesting of the top-level elements:

注意

The order in which you list the columns to nest determines the order in which the elements appear in the generated array.

Transformation Name	`Nest columns into Objects`
Parameter: Columns1	nest1
Parameter: Columns2	num3
Parameter: Nest columns to	Array
Parameter: New column name	nest2

In the generated columns, you notice that all values are quoted, even though these values are integers.

注意

Elements that are generated into arrays using a nest transformation are always rendered as quoted values.

You can use the following transformation to remove the quotes from the nest2 column:

Transformation Name	`Replace text or patterns`
Parameter: Column	nest2
Parameter: Find	'"'
Parameter: Replace	(empty)
Parameter: Match all occurrences	true

num1	num2	num3	nest2
11	12	13	[[11,12],13]
14	15	16	[[14,15],16]
17	18	19	[[17,18],19]

Nest Columns into Objects

You can nest multiple columns into a single column of objects using nest transform.

This section provides a simple example of nesting columns into a new column of Object data type.

Source:

In the following example, furniture product dimensions are stored in separate columns in cm.

Category	Name	Length_cm	Width_cm	Height_cm
bench	Hooska	118.11	74.93	46.34
lamp	Tansk	30.48	30.48	165.1
bookshelf	Brock	27.94	160.02	201.93
couch	Loafy	95	227	83

Transformation:

Use the nest transform to bundle the data into a single column.

Transformation Name	`Nest columns into Objects`
Parameter: Columns	Length_cm,Width_cm,Height_cm
Parameter: Nest columns to	Object
Parameter: New column name	'Dimensions'

Results:

Category	Name	Length_cm	Width_cm	Height_cm	Dimensions
bench	Hooska	118.11	74.93	46.34	{"Length_cm":"118.11","Width_cm":"74.93","Height_cm":"46.34"}
lamp	Tansk	30.48	30.48	165.1	{"Length_cm":"30.48","Width_cm":"30.48","Height_cm":"165.1"}
bookshelf	Brock	27.94	160.02	201.93	{"Length_cm":"27.94","Width_cm":"160.02","Height_cm":"201.93"}
couch	Loafy	95	227	83	{"Length_cm":"95,"Width_cm":"227","Height_cm":"83"}

Hybrids of Arrays and Objects

A single Array or Object can contain other Arrays, Objects, or both. In fact, this structuring is essentially the JSON file format. In this example, you can see how data, when laid out in a single table, can be assembled into a set of JSON records. See EXAMPLE - Nest JSON Records.

本节内容如下:

Nest Your Data

Nest Columns into Array

Nest Columns into Objects

Hybrids of Arrays and Objects

搜索结果