groupConcat

Calcula uma string concatenada a partir de um grupo de strings, opcionalmente separadas por um delimitador e, também opcionalmente, limitadas a um número máximo de elementos.

​

groupConcat

Introduzido em: v24.8.0

Calcula uma string concatenada a partir de um grupo de strings, opcionalmente separadas por um delimitador e, opcionalmente, limitada a um número máximo de elementos.

Se delimiter for especificado sem limit, ele deverá ser o primeiro parâmetro. Se tanto delimiter quanto limit forem especificados, delimiter deverá vir antes de limit.

Além disso, se delimitadores diferentes forem especificados como parâmetros e argumentos, apenas o delimitador dos argumentos será usado.

Sintaxe

groupConcat[(delimiter [, limit])](expression)

Aliases: group_concat, string_agg

Parâmetros

• delimiter — Uma string usada para separar os valores concatenados. Este parâmetro é opcional e, se não for especificado, o valor padrão será uma string vazia. String
• limit — Um inteiro positivo que especifica o número máximo de elementos a concatenar. Se houver mais elementos, os excedentes serão ignorados. Este parâmetro é opcional. UInt*

Argumentos

• expression — A expressão ou o nome da coluna que gera as strings a serem concatenadas. String
• delimiter — Uma string usada para separar os valores concatenados. Este parâmetro é opcional e, se não for especificado, o valor padrão será uma string vazia ou o delimitador definido nos parâmetros. String

Valor retornado

Retorna uma string composta pelos valores concatenados da coluna ou expressão. Se o grupo não tiver elementos ou tiver apenas elementos nulos, e a função não especificar um tratamento para casos com apenas valores nulos, o resultado será uma string Nullable com valor NULL. String

Exemplos

Uso básico sem delimitador

Query

SELECT groupConcat(Name) FROM Employees;

Response

JohnJaneBob

Usando a vírgula como delimitador (sintaxe do parâmetro)

Query

SELECT groupConcat(', ')(Name) FROM Employees;

Response

John, Jane, Bob

Usando a vírgula como delimitador (sintaxe do argumento)

Query

SELECT groupConcat(Name, ', ') FROM Employees;

Response

John, Jane, Bob

Limitando a quantidade de elementos concatenados

Query

SELECT groupConcat(', ', 2)(Name) FROM Employees;

Response

John, Jane