ClickHouse/docs/en/sql-reference/functions/array-join.md

36 lines
1.3 KiB
Markdown
Raw Normal View History

2020-04-03 13:23:32 +00:00
---
toc_priority: 61
toc_title: arrayJoin
---
# arrayJoin function {#functions_arrayjoin}
This is a very unusual function.
2020-03-20 10:10:48 +00:00
Normal functions dont change a set of rows, but just change the values in each row (map).
Aggregate functions compress a set of rows (fold or reduce).
2020-03-20 10:10:48 +00:00
The arrayJoin function takes each row and generates a set of rows (unfold).
This function takes an array as an argument, and propagates the source row to multiple rows for the number of elements in the array.
All the values in columns are simply copied, except the values in the column where this function is applied; it is replaced with the corresponding array value.
A query can use multiple `arrayJoin` functions. In this case, the transformation is performed multiple times.
Note the ARRAY JOIN syntax in the SELECT query, which provides broader possibilities.
Example:
``` sql
SELECT arrayJoin([1, 2, 3] AS src) AS dst, 'Hello', src
```
2020-03-20 10:10:48 +00:00
``` text
┌─dst─┬─\'Hello\'─┬─src─────┐
│ 1 │ Hello │ [1,2,3] │
│ 2 │ Hello │ [1,2,3] │
│ 3 │ Hello │ [1,2,3] │
└─────┴───────────┴─────────┘
```
2018-04-23 06:20:21 +00:00
2020-01-30 10:34:55 +00:00
[Original article](https://clickhouse.tech/docs/en/query_language/functions/array_join/) <!--hide-->