Skip to content

Commit ce15415

Browse files
authored
[Fix][Doc] Adjust the description of the explode function (#9168)
1 parent ff5fc12 commit ce15415

File tree

2 files changed

+29
-15
lines changed

2 files changed

+29
-15
lines changed

Diff for: docs/en/transform-v2/sql-functions.md

+15-8
Original file line numberDiff line numberDiff line change
@@ -1035,17 +1035,24 @@ select ARRAY(column1,column2,column3) as arrays
10351035

10361036
notes: Currently only string, double, long, int types are supported
10371037

1038-
### LATERAL VIEW
1038+
### LATERAL VIEW
10391039
#### EXPLODE
10401040

1041-
explode array column to rows.
1042-
OUTER EXPLODE will return NULL, while array is NULL or empty
1043-
EXPLODE(SPLIT(FIELD_NAME,separator))Used to split string type. The first parameter of SPLIT function is the field name, the second parameter is the separator
1044-
EXPLODE(ARRAY(value1,value2)) Used to custom array type.
1041+
Used to flatten array columns into multiple rows. It applies the EXPLODE function to an array and generates a new row for each element.
1042+
1043+
EXPLODE: Converts an array column into multiple rows. No rows generated if array is NULL or empty.
1044+
1045+
OUTER EXPLODE: Returns NULL when array is NULL or empty, ensuring at least one row is generated.
1046+
1047+
EXPLODE(SPLIT(field_name, separator)): Splits a string into an array using the specified separator, then explodes it into rows.
1048+
1049+
EXPLODE(ARRAY(value1, value2, ...)): Explodes a custom-defined array into multiple rows.
1050+
1051+
Example:
10451052
```
1046-
SELECT * FROM dual
1047-
LATERAL VIEW EXPLODE ( SPLIT ( NAME, ',' ) ) AS NAME
1048-
LATERAL VIEW EXPLODE ( SPLIT ( pk_id, ';' ) ) AS pk_id
1053+
SELECT * FROM dual
1054+
LATERAL VIEW EXPLODE ( SPLIT ( NAME, ',' ) ) AS NAME
1055+
LATERAL VIEW EXPLODE ( SPLIT ( pk_id, ';' ) ) AS pk_id
10491056
LATERAL VIEW OUTER EXPLODE ( age ) AS age
10501057
LATERAL VIEW OUTER EXPLODE ( ARRAY(1,1) ) AS num
10511058
```

Diff for: docs/zh/transform-v2/sql-functions.md

+14-7
Original file line numberDiff line numberDiff line change
@@ -1028,14 +1028,21 @@ select ARRAY(column1,column2,column3) as arrays
10281028
### LATERAL VIEW
10291029
#### EXPLODE
10301030

1031-
将 array 列展开成多行。
1032-
OUTER EXPLODE 当 array 为NULL或者为空时,返回NULL
1033-
EXPLODE(SPLIT(FIELD_NAME,separator))用来切分字符串类型,SPLIT 第一个参数是字段名,第二个参数是分隔符
1034-
EXPLODE(ARRAY(value1,value2)) 用于自定义数组切分,在原有基础上生成一个新的字段。
1031+
用于将数组列展开成多行。它通过对数组应用 EXPLODE 函数,为数组中的每个元素生成一个新行。
1032+
1033+
EXPLODE:将数组列转换为多行。如果数组为 NULL 或为空,则不生成行。
1034+
1035+
OUTER EXPLODE:当数组为 NULL 或为空时返回 NULL,确保至少生成一行。
1036+
1037+
EXPLODE(SPLIT(字段名, 分隔符)):使用指定的分隔符将字符串拆分为数组,然后将其展开为多行。
1038+
1039+
EXPLODE(ARRAY(值1, 值2, ...)):将自定义数组展开为多行。
1040+
1041+
示例:
10351042
```
1036-
SELECT * FROM fake
1037-
LATERAL VIEW EXPLODE ( SPLIT ( NAME, ',' ) ) AS NAME
1038-
LATERAL VIEW EXPLODE ( SPLIT ( pk_id, ';' ) ) AS pk_id
1043+
SELECT * FROM dual
1044+
LATERAL VIEW EXPLODE ( SPLIT ( NAME, ',' ) ) AS NAME
1045+
LATERAL VIEW EXPLODE ( SPLIT ( pk_id, ';' ) ) AS pk_id
10391046
LATERAL VIEW OUTER EXPLODE ( age ) AS age
10401047
LATERAL VIEW OUTER EXPLODE ( ARRAY(1,1) ) AS num
10411048
```

0 commit comments

Comments
 (0)