Generates an array of all unique elements among one or more arrays.
- Inputs are column names or array literals.
- If an element appears twice in one or more arrays, it is listed once in the output array.
Basic Usage
Array literal reference example:
derive type:single value:ARRAYUNIQUE([["A","B"],["A","C"]])
Output: Generates a single array:
["A","B","C"]
Single-column reference example:
derive type:single value:ARRAYUNIQUE([array1]) as:'unique_Array1'
Output: Generates a new unique_Array1 column containing a single array of all unique elements in array1.
Multi-column reference example:
derive type:single value:ARRAYUNIQUE([array1,array2]) as:'unique_Array2'
Output: Generates a new unique_Array2 column containing a single array listing all unique elements in array1 and array2.
Syntax and Arguments
derive type:single value:ARRAYUNIQUE(array_ref1,array_ref2)
| Argument | Required? | Data Type | Description |
|---|---|---|---|
| array_ref1 | Y | string or array | Name of first column or first array literal to apply to the function |
| array_ref2 | N | string or array | Name of second column or second array literal to apply to the function |
For more information on syntax standards, see Language Documentation Syntax Notes.
array_ref1, array_ref2
Array literals or names of the array columns whose unique elements you want to derive.
Usage Notes:
| Required? | Data Type | Example Value |
|---|---|---|
| Yes (at least one) | Array literal or column reference | myArray1, myArray2 |
Tip: For additional examples, see Common Tasks.
Examples
Example - Simple unique example
Source: Code formatting has been applied to improve legibility. Transform: You can apply the following transforms in the following order. Note that the column names must be different from the transform name, which is a reserved word.
ARRAYCONCAT - Concatenate multiple arrays together. See ARRAYCONCAT Function.ARRAYINTERSECT - Find the intersection of elements between multiple arrays. See ARRAYINTERSECT Function.ARRAYCROSS - Compute the cross product of multiple arrays. See ARRAYCROSS Function.ARRAYUNIQUE - Generate unique values across multiple arrays. See ARRAYUNIQUE Function.Item ArrayA ArrayB Item1 ["A","B","C"]
["1","2","3"]
Item2 ["A","B"]
["A","B","C"]
Item3 ["D","E","F"]
["4","5","6"]
derive type:single value:ARRAYCONCAT([Letters,Numerals]) as:'concat2'derive type:single value:ARRAYINTERSECT([Letters,Numerals]) as:'intersection2'derive type:single value:ARRAYCROSS([Letters,Numerals]) as:'cross2'derive type:single value:ARRAYUNIQUE([Letters,Numerals]) as:'unique2'Item ArrayA ArrayB concat2 intersection2 cross2 unique2 Item1 ["A","B","C"]
["1","2","3"]
["A","B","C","1","2","3"]
[ ]
[["A","1"],["A","2"],["A","3"],
["B","1"],["B","2"],["B","3"],
["C","1"],["C","2"],["C","3"]]
["A","B","C","1","2","3"]
Item2 ["A","B"]
["A","B","C"]
["A","B","A","B","C"]
["A","B"]
[["A","A"],["A","B"],["A","C"],
["B","A"],["B","B"],["B","C"]]
["A","B","C"]
Item3 ["D","E","F"]
["4","5","6"]
["D","E","F","4","5","6"]
[ ]
[["D","4"],["D","5"],["D","6"],
["E","4"],["E","5"],["E","6"],
["F","4"],["F","5"],["F","6"]]
["D","E","F","4","5","6"]
This page has no comments.