Todos os produtos
Search

Este produto

    MaxCompute:CONCAT

    Central de documentação

    MaxCompute:CONCAT

    Última atualização: Sep 22, 2026

    Concatena todos os elementos de múltiplos arrays e retorna um novo array, ou concatena várias strings e retorna uma nova string.

    Sintaxe

    array<T> concat(array<T> <a>, array<T> <b>[,...])
string concat(string <str1>, string <str2>[,...])

    Parâmetros

    • a e b: obrigatórios. Esses parâmetros especificam arrays. T em array<T> especifica o tipo de dados dos elementos nos arrays. Os elementos podem ser de qualquer tipo de dados. Os elementos do array a e do array b devem ter o mesmo tipo de dados. Os elementos nulos também são incluídos na operação.

    • str1 e str2: obrigatórios. Os valores são do tipo STRING. Se os valores de entrada forem dos tipos BIGINT, DOUBLE, DECIMAL ou DATETIME, a função os converte implicitamente para o tipo STRING antes do cálculo. Se os valores de entrada forem de outros tipos de dados, a função retorna um erro.

    Valor de retorno

    • A função retorna um valor do tipo ARRAY. Se um dos arrays de entrada for nulo, a função retorna null.

    • A função retorna um valor do tipo STRING. Se não houver parâmetros de entrada especificados ou se um parâmetro de entrada for null, a função retorna null.

    Exemplos

    • Exemplo 1: Concatene todos os elementos de array(10, 20) e array(20, -20). Instrução de exemplo:

      -- The return value is [10, 20, 20, -20]. 
select concat(array(10, 20), array(20, -20));

    • Exemplo 2: Um dos arrays de entrada contém um elemento nulo. Instrução de exemplo:

      -- The return value is [10, null, 20, -20]. 
select concat(array(10, null), array(20, -20));

    • Exemplo 3: Um dos arrays de entrada é nulo. Instrução de exemplo:

      -- The return value is null. 
select concat(array(10, 20), null);

    • Exemplo 4: Concatene as strings aabc e abcde. Instrução de exemplo:

      -- The return value is aabcabcde. 
select concat('aabc','abcde');

    • Exemplo 5: A entrada está vazia. Instrução de exemplo:

      -- The return value is null. 
select concat();

    • Exemplo 6: Uma das strings de entrada é nula. Instrução de exemplo:

      -- The return value is null. 
select concat('aabc', 'abcde', null);

    Funções relacionadas

    CONCAT é uma função para tipos complexos ou uma função de string.