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.

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

CREATE TABLE Employees (Name String) ENGINE = Memory;
INSERT INTO Employees VALUES ('John'), ('Jane'), ('Bob');

SELECT groupConcat(Name) FROM Employees;

JohnJaneBob

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

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

John, Jane, Bob

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

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

John, Jane, Bob

Limitando a quantidade de elementos concatenados

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

John, Jane