zclllyybb commented on code in PR #3220:
URL: https://github.com/apache/doris-website/pull/3220#discussion_r2750988408
##########
i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/map-functions/map-concat.md:
##########
@@ -0,0 +1,168 @@
+---
+{
+ "title": "MAP_CONCAT",
+ "language": "zh-CN"
+}
+---
+
+## 描述
+
+将多个 map 合并为一个 map。当合并具有不同键或值类型的 map 时，该函数会找到键和值的公共类型。
+
+:::info Note
+Supported since Apache Doris 4.0.4.
Review Comment:
中文文档里使用中文
##########
i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/map-functions/map-concat.md:
##########
@@ -0,0 +1,168 @@
+---
+{
+ "title": "MAP_CONCAT",
+ "language": "zh-CN"
+}
+---
+
+## 描述
+
+将多个 map 合并为一个 map。当合并具有不同键或值类型的 map 时，该函数会找到键和值的公共类型。
+
+:::info Note
+Supported since Apache Doris 4.0.4.
+:::
+
+## 语法
+
+```sql
+MAP_CONCAT(<map1> [, <map2> [, <map3> ... ]])
+```
+
+## 参数
+- `<map1>`, `<map2>`, `<map3>`, ...:
[`MAP`](../../../basic-element/sql-data-types/semi-structured/MAP.md)
类型，需要合并的输入 map。
+
+**支持的键和值类型：**
+- **键类型**：所有支持比较的基本类型（数值、字符串、日期/时间、布尔值、IP）
+- **值类型**：所有基本类型加上复杂类型（ARRAY、MAP、STRUCT）
+
+**类型兼容性说明：**
+- 当合并具有不同键类型的 map 时，函数会找到公共键类型
+- 当合并具有不同值类型的 map 时，函数会找到公共值类型
+
+## 返回值
+返回一个合并后的 `MAP`，包含所有输入 map 中的键值对。
Review Comment:
结果的顺序是如何的？
##########
i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/map-functions/map-concat.md:
##########
@@ -0,0 +1,168 @@
+---
+{
+ "title": "MAP_CONCAT",
+ "language": "zh-CN"
+}
+---
+
+## 描述
+
+将多个 map 合并为一个 map。当合并具有不同键或值类型的 map 时，该函数会找到键和值的公共类型。
+
+:::info Note
+Supported since Apache Doris 4.0.4.
+:::
+
+## 语法
+
+```sql
+MAP_CONCAT(<map1> [, <map2> [, <map3> ... ]])
+```
+
+## 参数
+- `<map1>`, `<map2>`, `<map3>`, ...:
[`MAP`](../../../basic-element/sql-data-types/semi-structured/MAP.md)
类型，需要合并的输入 map。
+
+**支持的键和值类型：**
+- **键类型**：所有支持比较的基本类型（数值、字符串、日期/时间、布尔值、IP）
+- **值类型**：所有基本类型加上复杂类型（ARRAY、MAP、STRUCT）
+
+**类型兼容性说明：**
+- 当合并具有不同键类型的 map 时，函数会找到公共键类型
+- 当合并具有不同值类型的 map 时，函数会找到公共值类型
+
+## 返回值
+返回一个合并后的 `MAP`，包含所有输入 map 中的键值对。
+
+**行为：**
+- 结果 map 的键类型是所有输入 map 键类型的公共类型
+- 结果 map 的值类型是所有输入 map 值类型的公共类型
+- 如果类型无法转换（例如，不兼容的键类型），则抛出错误
+
+## 使用说明
+1. 该函数接受零个或多个 map 参数。
+2. 如果任何参数为 NULL，则结果为 NULL。
+3. 重复键：如果多个 map 包含相同的键，则最后一个 map 的值生效
+
+## 示例
+1. 基本用法
+ ```sql
+ select map_concat();
+ ```
+ ```text
+ +--------------+
+ | map_concat() |
+ +--------------+
+ | {} |
+ +--------------+
+ ```
+
+ ```sql
+ select map_concat(map('single', 'argument'));
+ ```
+ ```text
+ +---------------------------------------+
+ | map_concat(map('single', 'argument')) |
+ +---------------------------------------+
+ | {"single":"argument"} |
+ +---------------------------------------+
+ ```
+
+ ```sql
+ select map_concat({'a': 'apple'}, {'b': 'banana'}, {'c': 'cherry'});
+ ```
+ ```text
+ +-----------------------------------------------------------+
+ | map_concat({'a':'apple'},{'b':'banana'},{'c':'cherry'}) |
+ +-----------------------------------------------------------+
+ | {"a":"apple", "b":"banana", "c":"cherry"} |
+ +-----------------------------------------------------------+
+ ```
+
+2. NULL 参数
+ ```sql
+ select map_concat({'a': 'apple'}, NULL);
+ ```
+ ```text
+ +---------------------------------+
+ | map_concat({'a':'apple'}, NULL) |
+ +---------------------------------+
+ | NULL |
+ +---------------------------------+
+ ```
+
+ 包含 null 元素的 map 合并：null 元素通常会在合并结果中保留。
Review Comment:
不要使用这种模糊的说法，讲清楚究竟何时保留何时不保留
--
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]
