全部產品

MaxCompute：CONCAT_WS

更新時間：Feb 28, 2024

返回將參數中的所有字串或ARRAY數組中的元素按照指定的分隔字元串連在一起的結果。此函數為MaxCompute 2.0擴充函數。

命令格式

string concat_ws(string <separator>, string <str1>, string <str2>[,...])
string concat_ws(string <separator>, array<string> <a>)

參數說明

separator：必填。STRING類型的分隔字元。
str1、str2：至少要指定2個字串。STRING類型。如果輸入為BIGINT、DECIMAL、DOUBLE或DATETIME類型，則會隱式轉換為STRING類型後參與運算。
a：必填。ARRAY數組。數組中的元素為STRING類型。

傳回值說明

返回STRING類型或STRUCT類型。返回規則如下：

str1或str2非STRING、BIGINT、DECIMAL、DOUBLE或DATETIME類型時，返回報錯。
如果沒有輸入參數或任一輸入參數值為NULL，返回NULL。

使用樣本

樣本1：將字串name和hanmeimei通過:串連。命令樣本如下。
```
--返回name:hanmeimei。
select concat_ws(':','name','hanmeimei');
```
-
樣本2：任一輸入參數為NULL。命令樣本如下。
```
--返回NULL。
select concat_ws(':','avg',null,'34');
```
樣本3：將ARRAY數組array('name', 'hanmeimei')中的元素通過:串連。命令樣本如下。
```
--返回name:hanmeimei。
select concat_ws(':',array('name', 'hanmeimei'));
```

相關函數

CONCAT_WS函數屬於字串函數，更多尋找字串、轉換字串格式的相關函數請參見字串函數。