文档

CONCAT_WS

更新时间:

返回将参数中的所有字符串或ARRAY数组中的元素按照指定的分隔符连接在一起的结果。此函数为MaxCompute 2.0扩展函数。

命令格式

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

参数说明

  • separator:必填。STRING类型的分隔符。

  • str1str2:至少要指定2个字符串。STRING类型。如果输入为BIGINT、DECIMAL、DOUBLE或DATETIME类型,则会隐式转换为STRING类型后参与运算。

  • a:必填。ARRAY数组。数组中的元素为STRING类型。

返回值说明

返回STRING类型或STRUCT类型。返回规则如下:

  • str1str2非STRING、BIGINT、DECIMAL、DOUBLE或DATETIME类型时,返回报错。

  • 如果没有输入参数或任一输入参数值为NULL,返回NULL。

使用示例

  • 示例1:将字符串namehanmeimei通过:连接。命令示例如下。

    --返回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函数属于字符串函数,更多查找字符串、转换字符串格式的相关函数请参见字符串函数