본문으로 건너뛰기
최종 수정: 에

ARRAY_DISTINCT

array_distinct​

SinceVersion 2.0.0

설명​

배열에서 중복 요소를 제거하고 고유한 요소를 포함하는 새 배열을 반환합니다. 이 함수는 각 요소가 처음 나타나는 위치의 값만 유지하여 요소의 원래 순서를 보존합니다.

구문​

array_distinct(ARRAY<T> arr)

매개변수​

  • arr：ARRAY<T> 타입으로, 중복을 제거할 배열입니다. 컬럼 이름 또는 상수 값을 지원합니다.

T가 지원하는 타입:

  • 숫자 타입: TINYINT, SMALLINT, INT, BIGINT, LARGEINT, FLOAT, DOUBLE, DECIMAL
  • 문자열 타입: CHAR, VARCHAR, STRING
  • 날짜 및 시간 타입: DATE, DATETIME, DATEV2, DATETIMEV2, TIMESTAMP_NS
  • 불리언 타입: BOOLEAN
  • IP 타입: IPV4, IPV6
  • UUID: UUID

반환값​

반환 타입: ARRAY<T>

반환값의 의미:

  • 원래 배열의 고유한 요소를 모두 포함하며 중복을 제거한 배열
  • 요소의 원래 순서 유지
  • NULL: 입력 배열이 NULL인 경우

사용 시 참고 사항:

  • 이 함수는 배열을 왼쪽에서 오른쪽으로 순회하며 각 요소가 처음 나타나는 위치의 값만 유지하고, 이후에 나타나는 중복 요소는 제거합니다.
  • 빈 배열은 빈 배열을 반환하고, NULL 배열은 NULL을 반환합니다.
  • 중복을 제거해도 원래 배열에 있는 요소의 상대적인 순서는 유지되며, 순서를 재정렬하지 않습니다.
  • 배열 요소에 null 값이 있는 경우: null 요소도 중복을 제거하며, null이 여러 개 있으면 하나만 유지합니다.

예제​

쿼리 예제:

정수 배열의 중복 제거: 원래 배열 [1, 2, 3, 4, 5]에는 중복 요소가 없으므로 중복을 제거한 결과는 원래 배열과 같습니다.

SELECT array_distinct([1, 2, 3, 4, 5]);
+---------------------------------+
| array_distinct([1, 2, 3, 4, 5]) |
+---------------------------------+
| [1, 2, 3, 4, 5]                 |
+---------------------------------+

문자열 배열의 중복 제거: 중복된 문자열 요소를 제거합니다. 원래 배열 ['a', 'b', 'a', 'c', 'b', 'd']에서 'a'는 두 번 나타나므로 첫 번째 항목만 유지하고, 'b'도 두 번 나타나므로 첫 번째 항목만 유지합니다. 중복을 제거한 결과는 ["a", "b", "c", "d"]입니다.

SELECT array_distinct(['a', 'b', 'a', 'c', 'b', 'd']);
+------------------------------------------------+
| array_distinct(['a', 'b', 'a', 'c', 'b', 'd']) |
+------------------------------------------------+
| ["a", "b", "c", "d"]                           |
+------------------------------------------------+

null 값을 포함하는 배열: null 요소도 중복을 제거하며, null이 여러 개 있으면 하나만 유지합니다. 원래 배열 [1, null, 2, null, 3, null]에서 null은 세 번 나타나지만, 중복을 제거하면 첫 번째 null만 유지되므로 결과는 [1, null, 2, 3]입니다.

SELECT array_distinct([1, null, 2, null, 3, null]);
+---------------------------------------------+
| array_distinct([1, null, 2, null, 3, null]) |
+---------------------------------------------+
| [1, null, 2, 3]                             |
+---------------------------------------------+

IP 타입 배열의 중복 제거: IPv4 주소 배열의 중복을 제거합니다. 원래 배열 ['192.168.1.1', '192.168.1.2', '192.168.1.1']에서 '192.168.1.1'은 두 번 나타나지만, 중복을 제거하면 해당 주소가 처음 나타나는 위치의 값만 유지되므로 결과는 [192.168.1.1, 192.168.1.2]입니다.

SELECT array_distinct(CAST(['192.168.1.1', '192.168.1.2', '192.168.1.1'] AS ARRAY<IPV4>));
+------------------------------------------------------------------------------------+
| array_distinct(CAST(['192.168.1.1', '192.168.1.2', '192.168.1.1'] AS ARRAY<IPV4>)) |
+------------------------------------------------------------------------------------+
| ["192.168.1.1", "192.168.1.2"]                                                     |
+------------------------------------------------------------------------------------+

IPv6 타입 배열의 중복 제거: IPv6 주소 배열의 중복을 제거합니다. 원래 배열 ['2001:db8::1', '2001:db8::2', '2001:db8::1']에서 '2001:db8::1'은 두 번 나타나지만, 중복을 제거하면 해당 주소가 처음 나타나는 위치의 값만 유지되므로 결과는 [2001:db8::1, 2001:db8::2]입니다.

SELECT array_distinct(CAST(['2001:db8::1', '2001:db8::2', '2001:db8::1'] AS ARRAY<IPV6>));
+------------------------------------------------------------------------------------+
| array_distinct(CAST(['2001:db8::1', '2001:db8::2', '2001:db8::1'] AS ARRAY<IPV6>)) |
+------------------------------------------------------------------------------------+
| ["2001:db8::1", "2001:db8::2"]                                                     |
+------------------------------------------------------------------------------------+

빈 배열은 빈 배열을 반환합니다. 빈 배열에는 중복을 제거할 요소가 없으므로 빈 배열을 그대로 반환합니다.

SELECT array_distinct([]);
+--------------------+
| array_distinct([]) |
+--------------------+
| []                 |
+--------------------+

NULL 배열은 NULL을 반환합니다. 입력 배열이 NULL이면 오류를 발생시키지 않고 NULL을 반환합니다.

SELECT array_distinct(NULL);
+----------------------+
| array_distinct(NULL) |
+----------------------+
| NULL                 |
+----------------------+

요소가 하나인 배열은 원래 배열을 반환합니다. 요소가 하나뿐인 배열에는 중복 요소가 없으므로 중복을 제거한 결과는 원래 배열과 같습니다.

SELECT array_distinct([42]);
+----------------------+
| array_distinct([42]) |
+----------------------+
| [42]                 |
+----------------------+

지원하지 않는 복합 타입:

중첩 배열 타입은 지원하지 않으며 오류가 발생합니다.

SELECT array_distinct([[1,2,3], [4,5,6], [1,2,3]]);
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.6)[RUNTIME_ERROR]execute failed or unsupported types for function array_distinct(Array(Nullable(Array(Nullable(TINYINT)))))

Map 타입은 지원하지 않으며 오류가 발생합니다.

SELECT array_distinct([{'a':1}, {'b':2}, {'a':1}]);
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.6)[RUNTIME_ERROR]execute failed or unsupported types for function array_distinct(Array(Nullable(Map(Nullable(String), Nullable(TINYINT)))))

Struct 타입은 지원하지 않으며 오류가 발생합니다.

SELECT array_distinct(array(named_struct('name','Alice','age',20), named_struct('name','Bob','age',30), named_struct('name','Alice','age',20)));
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.6)[RUNTIME_ERROR]execute failed or unsupported types for function array_distinct(Array(Nullable(Struct(name:Nullable(String), age:Nullable(TINYINT)))))

매개변수 개수가 올바르지 않으면 오류가 발생합니다. array_distinct 함수는 배열 매개변수를 하나만 받으므로 여러 매개변수를 전달하면 오류가 발생합니다.

SELECT array_distinct([1, 2, 3], [4, 5, 6]);
ERROR 1105 (HY000): errCode = 2, detailMessage = Can not found function 'array_distinct' which has 2 arity. Candidate functions are: [array_distinct(Expression)]

배열이 아닌 타입을 전달하면 오류가 발생합니다. array_distinct 함수는 배열 타입 매개변수만 받으므로 문자열과 같이 배열이 아닌 타입을 전달하면 오류가 발생합니다.

SELECT array_distinct('not_an_array');
ERROR 1105 (HY000): errCode = 2, detailMessage = Can not find the compatibility function signature: array_distinct(VARCHAR(12))

키워드​

ARRAY, DISTINCT, ARRAY_DISTINCT

Report issue