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.
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.
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 BYpara 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 BYpara 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 BYeORDER BYpara 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 BYeORDER BYpara 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.