MySQL tem um
GROUP_CONCAT()
função que nos permite retornar colunas de uma consulta como uma lista delimitada. Ele retorna um resultado de string com o não-
NULL
concatenado valores de um grupo. Sintaxe
A sintaxe fica assim:
GROUP_CONCAT([DISTINCT] expr [,expr ...]
[ORDER BY {unsigned_integer | col_name | expr}
[ASC | DESC] [,col_name ...]]
[SEPARATOR str_val])
Exemplo
Suponha que executemos a seguinte consulta:
SELECT PetName
FROM Pets;
E obtemos o seguinte resultado:
+---------+ | PetName | +---------+ | Fluffy | | Fetch | | Scratch | | Wag | | Tweet | | Fluffy | | Bark | | Meow | +---------+ 8 rows in set (0.00 sec)
Podemos usar
GROUP_CONCAT()
para retornar todas essas linhas como uma lista delimitada. Para fazer isso, precisamos passar o
PetName
coluna como um argumento para o GROUP_CONCAT()
função:SELECT GROUP_CONCAT(PetName)
FROM Pets;
Resultado:
+-------------------------------------------------+ | GROUP_CONCAT(PetName) | +-------------------------------------------------+ | Fluffy,Fetch,Scratch,Wag,Tweet,Fluffy,Bark,Meow | +-------------------------------------------------+ 1 row in set (0.01 sec)
Pedidos
Podemos usar o
ORDER BY
cláusula para ordenar a saída desta função:SELECT GROUP_CONCAT(PetName ORDER BY PetName ASC)
FROM Pets;
Resultado:
Bark,Fetch,Fluffy,Fluffy,Meow,Scratch,Tweet,Wag
Observe que isso apenas classifica a saída do
GROUP_CONCAT()
função – é completamente independente de qualquer ordenação aplicada ao SELECT
própria declaração. O DISTINCT
Cláusula
Podemos usar o
DISTINCT
cláusula para retornar valores exclusivos. Em outras palavras, se houver valores duplicados, apenas uma ocorrência será retornada:SELECT GROUP_CONCAT(DISTINCT PetName ORDER BY PetName ASC)
FROM Pets;
Resultado:
Bark,Fetch,Fluffy,Meow,Scratch,Tweet,Wag
Neste caso,
Fluffy
só aparece uma vez. Quando o executamos sem o DISTINCT
cláusula, Fluffy
aparece duas vezes. Mudando o separador
Por padrão, a lista usa a vírgula como delimitador. Mas podemos mudar isso se quisermos:
SELECT GROUP_CONCAT(PetName SEPARATOR '-')
FROM Pets;
Resultado:
Fluffy-Fetch-Scratch-Wag-Tweet-Fluffy-Bark-Meow
Podemos até usar uma string vazia para remover todos os separadores (para que os valores sejam concatenados):
SELECT GROUP_CONCAT(PetName SEPARATOR '')
FROM Pets;
E obtemos o seguinte resultado:
FluffyFetchScratchWagTweetFluffyBarkMeow
Resultados da consulta agrupada
Podemos incluir
GROUP_CONCAT()
em uma consulta com um GROUP BY
cláusula para obter um resultado como este:SELECT
PetTypeId,
GROUP_CONCAT(PetName ORDER BY PetName ASC)
FROM Pets
GROUP BY PetTypeId
ORDER BY PetTypeId;
Resultado:
+-----------+--------------------------------------------+ | PetTypeId | GROUP_CONCAT(PetName ORDER BY PetName ASC) | +-----------+--------------------------------------------+ | 1 | Tweet | | 2 | Fluffy,Meow,Scratch | | 3 | Bark,Fetch,Fluffy,Wag | +-----------+--------------------------------------------+
No meu banco de dados, os nomes reais dos tipos de animais de estimação estão em outra tabela chamada
PetTypes
. Portanto, poderíamos executar um INNER JOIN
nos PetTypes
table para obter os nomes reais dos tipos de animais de estimação:SELECT
pt.PetType,
GROUP_CONCAT(p.PetName ORDER BY p.PetName ASC)
FROM Pets p
INNER JOIN PetTypes pt ON
p.PetTypeId = pt.PetTypeId
GROUP BY pt.PetType
ORDER BY pt.PetType ASC;
Resultado:
+---------+------------------------------------------------+ | PetType | GROUP_CONCAT(p.PetName ORDER BY p.PetName ASC) | +---------+------------------------------------------------+ | Bird | Tweet | | Cat | Fluffy,Meow,Scratch | | Dog | Bark,Fetch,Fluffy,Wag | +---------+------------------------------------------------+
Limitações de comprimento
GROUP_CONCAT()
A saída de é truncada para o comprimento máximo fornecido pelo group_concat_max_len
variável do sistema, que tem um valor padrão de 1024
. O valor pode ser definido mais alto, embora o comprimento máximo efetivo do valor de retorno seja limitado pelo valor de max_allowed_packet
. Você pode verificar o valor atual assim:
SHOW VARIABLES LIKE '%group_concat%';
A sintaxe para alterar esse valor é a seguinte:
SET [GLOBAL | SESSION] group_concat_max_len = val;
Onde
val
é um inteiro sem sinal.