Todos os produtos
Search
Central de documentação

MaxCompute:WM_CONCAT

Última atualização: Aug 20, 2026

Concatena os valores em colname com um delimitador especificado por separator.

Observações de uso

  • O MaxCompute V2.0 oferece novas funções estendidas. Se as funções utilizadas envolverem novos tipos de dados, como TINYINT, SMALLINT, INT, FLOAT, VARCHAR, TIMESTAMP e BINARY, execute uma instrução para ativar a edição de tipos de dados do MaxCompute V2.0:

    • Nível de sessão: adicione SET odps.sql.type.system.odps2=true; antes da instrução SQL a ser executada e envie ambas juntas para execução.

    • Nível de projeto: o proprietário do projeto pode ativar a edição de tipos de dados do MaxCompute V2.0 conforme as necessidades do projeto. Instrução:

      setproject odps.sql.type.system.odps2=true;

      A configuração entra em vigor após 10 a 15 minutos.

      Para obter mais informações sobre setproject, consulte Project operations. Para detalhes sobre os cuidados necessários ao ativar a edição de tipos de dados do MaxCompute V2.0 no nível do projeto, veja Data type version guide.

  • Se uma instrução SQL incluir múltiplas funções de agregação e os recursos do projeto forem insuficientes, poderá ocorrer estouro de memória. Otimize a instrução SQL ou adquira recursos computacionais adicionais, conforme necessário.

Sintaxe

string wm_concat(string <separator>, string <colname>)

Parâmetros

  • separator: obrigatório. Delimitador constante do tipo STRING.

  • colname: obrigatório. Valor do tipo STRING. Valores de entrada dos tipos BIGINT, DOUBLE ou DATETIME são convertidos implicitamente para STRING antes do cálculo.

Nota

Ao usar a função WM_CONCAT combinada com a expressão within group (order by <col1>[,<col2>…]) e a palavra-chave DISTINCT, observe atentamente a sintaxe da função. Para mais detalhes sobre a sintaxe de funções de agregação, consulte Syntax.

Valor retornado

Use esta função com a cláusula GROUP BY. A cláusula ORDER BY não é especificada.

Retorna um valor do tipo STRING. O valor retornado segue as regras abaixo:

  • Se o valor de separator não for uma constante do tipo STRING, a função retornará um erro.

  • Caso o valor de colname não seja dos tipos STRING, BIGINT, DOUBLE ou DATETIME, a função retornará um erro.

  • Se o valor de colname for nulo, a linha correspondente será ignorada no cálculo.

Nota

Se table_name na instrução select wm_concat(',', name) from table_name; representar um conjunto vazio, o retorno será nulo.

Dados de exemplo

Esta seção apresenta dados de origem e exemplos para facilitar o entendimento das funções. Crie uma tabela chamada emp e insira os dados de exemplo. Instrução de exemplo:

CREATE TABLE IF NOT EXISTS emp
   (empno BIGINT,
    ename STRING,
    job STRING,
    mgr BIGINT,
    hiredate DATETIME,
    sal BIGINT,
    comm BIGINT,
    deptno BIGINT);
tunnel upload emp.txt emp;   --Replace emp.txt with the actual path (path and name) to which you upload the data file

O arquivo emp.txt contém os seguintes dados de exemplo:

7369,SMITH,CLERK,7902,1980-12-17 00:00:00,800,,20
7499,ALLEN,SALESMAN,7698,1981-02-20 00:00:00,1600,300,30
7521,WARD,SALESMAN,7698,1981-02-22 00:00:00,1250,500,30
7566,JONES,MANAGER,7839,1981-04-02 00:00:00,2975,,20
7654,MARTIN,SALESMAN,7698,1981-09-28 00:00:00,1250,1400,30
7698,BLAKE,MANAGER,7839,1981-05-01 00:00:00,2850,,30
7782,CLARK,MANAGER,7839,1981-06-09 00:00:00,2450,,10
7788,SCOTT,ANALYST,7566,1987-04-19 00:00:00,3000,,20
7839,KING,PRESIDENT,,1981-11-17 00:00:00,5000,,10
7844,TURNER,SALESMAN,7698,1981-09-08 00:00:00,1500,0,30
7876,ADAMS,CLERK,7788,1987-05-23 00:00:00,1100,,20
7900,JAMES,CLERK,7698,1981-12-03 00:00:00,950,,30
7902,FORD,ANALYST,7566,1981-12-03 00:00:00,3000,,20
7934,MILLER,CLERK,7782,1982-01-23 00:00:00,1300,,10
7948,JACCKA,CLERK,7782,1981-04-12 00:00:00,5000,,10
7956,WELAN,CLERK,7649,1982-07-20 00:00:00,2450,,10
7956,TEBAGE,CLERK,7748,1982-12-30 00:00:00,1300,,10

Exemplos

  • Exemplo 1: concatene os valores da coluna ename de todos os funcionários. Instrução de exemplo:

    select wm_concat(',', ename) from emp;

    Resultado:

    +------------+
    | _c0        |
    +------------+
    | SMITH,ALLEN,WARD,JONES,MARTIN,BLAKE,CLARK,SCOTT,KING,TURNER,ADAMS,JAMES,FORD,MILLER,JACCKA,WELAN,TEBAGE |
    +------------+
  • Exemplo 2: use esta função com GROUP BY para agrupar todos os funcionários por departamento (deptno) e concatenar os nomes (ename) de cada departamento. Instrução de exemplo:

    select deptno, wm_concat(',', ename) from emp group by deptno order by deptno;

    Resultado:

    +------------+------------+
    | deptno     | _c1        |
    +------------+------------+
    | 10         | CLARK,KING,MILLER,JACCKA,WELAN,TEBAGE |
    | 20         | SMITH,JONES,SCOTT,ADAMS,FORD |
    | 30         | ALLEN,WARD,MARTIN,BLAKE,TURNER,JAMES |
    +------------+------------+
  • Exemplo 3: utilize esta função com GROUP BY para agrupar todos os funcionários por departamento (deptno) e concatenar os salários de cada departamento, removendo duplicatas. Instrução de exemplo:

    select deptno, wm_concat(distinct ',', sal) from emp group by deptno order by deptno;

    Resultado:

    +------------+------------+
    | deptno     | _c1        |
    +------------+------------+
    | 10         | 1300,2450,5000 |
    | 20         | 1100,2975,3000,800 |
    | 30         | 1250,1500,1600,2850,950 |
    +------------+------------+
  • Exemplo 4: combine esta função com GROUP BY e ORDER BY para agrupar todos os funcionários por departamento (deptno), concatenar os valores salariais (sal) de cada departamento e ordená-los conforme uma sequência específica. Instrução de exemplo:

    select deptno, wm_concat(',',sal) within group (order by sal) from emp group by deptno order by deptno;

    Resultado:

    +------------+------------+
    |deptno|_c1|
    +------------+------------+
    |10|1300,1300,2450,2450,5000,5000|
    |20|800,1100,2975,3000,3000|
    |30|950,1250,1250,1500,1600,2850|
    +------------+------------+
  • Exemplo 5: aplique esta função com GROUP BY e ORDER BY para classificar as colunas especificadas em uma ordem definida. Instrução de exemplo:

    SELECT
        g,
        wm_concat ('#', t) WITHIN GROUP (ORDER BY h DESC) AS t_t
    FROM
    VALUES ("24",1,10),
           ("234",2,100),
           ("555",1,20),
           ("123", 2,30),
           ("7",1,11),
           ("13",3,50) AS tmp (t,g,h)
    GROUP BY g;
    

    Resultado:

    +------+-----+
    | g    | t_t |
    +------+-----+
    | 1    | 555#7#24 |
    | 2    | 234#123 |
    | 3    | 13  |
    +------+-----+

Funções relacionadas

WM_CONCAT é uma função de agregação. Para mais informações sobre funções usadas para calcular a média de vários registros de entrada e agregar parâmetros, consulte Aggregate functions.