Outdated Version

You are viewing an older version of this section. View current production version.

GROUP_CONCAT

Aggregate function. Concatenates all of the values passed in during aggregation.

Info

This aggregate function is not to be confused with CONCAT, which is a non-aggregate function returning a concatenation of its list of arguments.

Syntax

GROUP_CONCAT( [DISTINCT]
           expression, [ expression, [expression ...]]
           [SEPARATOR string] )

Arguments

  • DISTINCT: optionally filter the result set for only unique sets of expressions
  • expression: any set of expressions. This may be a column name, the result of another function, or a math operation.
  • SEPARATOR string: by default, the separator character is the comma “,". This argument overrides the default.

Note: You cannot use the DISTINCT keyword with the ORDER BY clause in a GROUP_CONCAT function.

Return Type

The return type is a string. The result is made up of the concatenated non-NULL values from the given group, or NULL if there are no non-NULL values. The variable group_concat_max_len controls the maximum length string this function can return. For more information on this variable, see the List of Engine Variables.

Examples

SELECT GROUP_CONCAT(ship_code) FROM products;
****
+-------------------------+
| GROUP_CONCAT(ship_code) |
+-------------------------+
| A,B,A,A,C,D,A,B         |
+-------------------------+
SELECT GROUP_CONCAT(DISTINCT ship_code) AS distinct_codes FROM products;
****
+----------------+
| distinct_codes |
+----------------+
| A,B,C,D        |
+----------------+
SELECT GROUP_CONCAT(DISTINCT ship_code SEPARATOR " ") AS distinct_codes FROM products;
****
+----------------+
| distinct_codes |
+----------------+
| A B C D        |
+----------------+
SELECT GROUP_CONCAT(first_name, " ", last_name) FROM BFFs;
****
+------------------------------------------+
| GROUP_CONCAT(first_name, " ", last_name) |
+------------------------------------------+
| Cecelia Cruz,Ari Floo,Skylar Rhodes      |
+------------------------------------------+