yiguolei commented on code in PR #2685:
URL: https://github.com/apache/doris-website/pull/2685#discussion_r2247038088
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/array-functions/array-zip.md:
##########
@@ -5,36 +5,79 @@
}
---
-## 描述
+## 功能
-将所有数组合并成一个单一的数组。结果数组包含源数组中按参数列表顺序分组的相应元素。
+`ARRAY_ZIP` 函数用于将多个 `ARRAY` (如 `arr1, arr2, ... , arrN`)
按元素位置组合成一个`ARRAY<STRUCT>`，其中每个 `STRUCT` 包含来自各个输入数组对应位置的元素。
## 语法
-```sql
-ARRAY_ZIP(<array>[, <array> ])
+```SQL
+ARRAY_ZIP(arr1, arr2, ... , arrN)
```
## 参数
-| 参数 | 说明 |
-|--|------|
-| `<array>` | 输入数组 |
+- `arr1, arr2, ..., arrN`：输入的 N 个数组，类型为 `ARRAY<T1>, ARRAY<T2>, ..., ARRAY<Tn>`。
+ - 输入的参数可以是构造的常量，也可以是变量。
+ - 某一个数组为 NULL 时，函数结果为 NULL（见示例）。
## 返回值
-返回来自源数组的元素分组成结构体的数组。结构体中的数据类型与输入数组的类型相同，并按照传递数组的顺序排列。
+- 返回值类型是 `ARRAY<STRUCT<col1 T1, col2 T2, ..., colN Tn>>`，其中每个 `STRUCT`
代表输入数组在同一索引位置上的组合。
-## 举例
-```sql
-SELECT ARRAY_ZIP(['a', 'b', 'c'], [1, 2, 3]);
-```
+## 使用说明
-```text
-+--------------------------------------------------------+
-| array_zip(['a', 'b', 'c'], [1, 2, 3]) |
-+--------------------------------------------------------+
-| [{"1":"a", "2":1}, {"1":"b", "2":2}, {"1":"c", "2":3}] |
-+--------------------------------------------------------+
-```
+1. **如果多个数组长度不一致，函数执行失败，返回 `RUNTIME_ERROR`**。
+2. 支持不同类型的数组输入，返回的结构体字段类型与输入数组一一对应。
+3. 可用于将多个并行数组组合成结构化格式，方便进一步的处理或分析。
Review Comment:
如果输入的array的长度不一样怎么办？
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
