Page tree


Our documentation site is moving!

For up-to-date documentation of Designer Cloud on AWS, please visit us at


Evaluates a String input against the Array datatype. If the input matches, the function outputs an Array value. Input can be a literal, a column of values, or a function returning String values.

After you have converted your strings to arrays, if a sufficient percentage of input strings from a column are successfully converted to the other data type, the column may be retyped. 

Tip: If the column is not automatically retyped as a result of this function, you can manually set the type to Array in a subsequent recipe step.

Wrangle vs. SQL: This function is part of Wrangle, a proprietary data transformation language. Wrangle is not SQL. For more information, see Wrangle Language.

Basic Usage


Output: Returns the Array data type value for strInput String values.

Syntax and Arguments


ArgumentRequired?Data TypeDescription
str_inputYStringLiteral, name of a column, or a function returning String values to match

For more information on syntax standards, see Language Documentation Syntax Notes.


Literal, column name, or function returning String values that are to be evaluated for conversion to Array values.

  • Missing values for this function in the source data result in null values in the output.
  • Multiple columns and wildcards are not supported.

Usage Notes:

Required?Data TypeExample Value


Tip: For additional examples, see Common Tasks.

Example - parsing strings as an array


The following table represents raw imported CSV data:


In the above table, you can see that the two items columns are interpreted differently. In the following steps, you can see how you can parse the data as array values before producing a new column intersecting the two arrays.


Create a new column to store the array version of itemsA:

Transformation Name New formula
Parameter: Formula type Single row formula
Parameter: Formula itemsA
Parameter: New column name arrA

Remove the quotes from the column:

Transformation Name Replace text or pattern
Parameter: Column arrA
Parameter: Find `"`
Parameter: Replace with ''
Parameter: Match all occurrences true

Now create the array by merging the array text value with square brackets and then using the PARSEARRAY function to evaluate the merged value as an array:

Transformation Name Edit column with formula
Parameter: Columns arrA
Parameter: Formula parsearray(merge(['[',arrA,']']))

You can create the second array column using a similar construction in a new column:

Transformation Name New formula
Parameter: Formula type Single row formula
Parameter: Formula parsearray(merge(['[',itemsB,']']))
Parameter: New column name arrB

Since both columns have been parsed as array values, you can use the ARRAYINTERSECT function to find the common values:

Transformation Name New formula
Parameter: Formula type Single row formula
Parameter: Formula arrayintersect([arrA,arrB])
Parameter: New column name arrIntersectAB



This page has no comments.