メインコンテンツまでスキップ
に最終更新

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
  • 真偽値型：BOOLEAN
  • IP 型：IPV4、IPV6

戻り値​

戻り値の型：ARRAY<T>

戻り値の意味：

  • 元の配列に含まれる一意の要素をすべて保持した、重複除去後の配列
  • 要素の元の順序を維持します
  • 入力配列が 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 要素も重複除去の対象となり、複数ある場合は一つだけ残ります。元の配列 [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