Skip to main content
Version: Stable-3.1

array_distinct

Description​

Removes duplicate elements from an array.

Syntax​

array_distinct(array)

Parameters​

array: the array from which you want to remove duplicate elements. Only the ARRAY data type is supported.

Return value​

Returns an array.

Usage notes​

  • The elements of the array that is returned may be sorted in a different order than the elements of the array that you specify.

  • The elements of the array that is returned are of the same data type as the elements of the array that you specify.

Examples​

In this section, the following table is used as an example:

mysql> select * from test;

+------+---------------+

| c1   | c2            |

+------+---------------+

|    1 | [1,1,2]       |

|    2 | [1,null,null] |

|    3 | NULL          |

|    4 | [null]        |

+------+---------------+

Remove duplicate values from column c2.

mysql> select c1, array_distinct(c2) from test;

+------+----------------------+

| c1   | array_distinct(`c2`) |

+------+----------------------+

|    1 | [2,1]                |

|    2 | [null,1]             |

|    3 | NULL                 |

|    4 | [null]               |

+------+----------------------+