Todos os produtos
Search
Central de documentação

MaxCompute:ARRAY_JOIN

Última atualização: Sep 22, 2026

Concatena os elementos do Array a usando um delimiter. Se o array contiver um elemento nulo, use nullreplacement para especificar a string que substituirá o elemento nulo nos resultados. Se você não configurar nullreplacement, o elemento nulo será ignorado.

Sintaxe

array_join(array<T> <a>, <delimiter>[, <nullreplacement>])

Parâmetros

  • a: obrigatório. Especifica um array. T em array<T> indica o tipo de dados dos elementos no array.

    Nota

    Se os elementos do array não forem do tipo STRING, o MaxCompute converterá o tipo de dados dos elementos para STRING.

  • delimiter: obrigatório. Um valor do tipo STRING. Indica a string usada para separar os elementos concatenados no Array a.

  • nullreplacement: opcional. Indica a string usada para substituir elementos nulos.

Valor de retorno

Retorna um valor do tipo STRING.

Exemplos

-- The return value is 10,20,20,30. 
select array_join(array(10, 20, 20, null, null, 30), ",");
-- The return value is 10##20##20##null##null##30. 
select array_join(array(10, 20, 20, null, null, 30), "##", "null");

Funções relacionadas

ARRAY_JOIN é uma função de tipo complexo. Para obter mais informações sobre as funções usadas para processar dados de tipos complexos, como ARRAY, MAP, STRUCT e JSON, consulte Complex type functions.