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要素は重複除去され、複数のnullは1つだけ保持される

例

クエリ例:

整数配列の重複除去、元の配列 [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' が2回出現し（最初の出現を保持）、'b' が2回出現し（最初の出現を保持）、重複排除後は ["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つだけ保持されます。元の配列[1, null, 2, null, 3, null]では、nullが3回出現しますが、重複除去後は最初の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'が2回出現しているため、重複排除後はそのアドレスの最初の出現のみが保持され、[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'が2回出現しており、重複除去後はアドレスの最初の出現のみが保持され、[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"]                                                     |
+------------------------------------------------------------------------------------+

空の配列は空の配列を返します：空の配列には重複排除する要素がないため、直接空の配列を返します。

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

NULL配列はNULLを返します：入力配列がNULLの場合、エラーを投げることなくNULLを返します。

+----------------------+
| array_distinct(NULL) |
+----------------------+
| NULL                 |
+----------------------+

単一要素配列は元の配列を返す：1つの要素のみを持つ配列には重複要素がないため、重複除去後の結果は元の配列と同じになる。

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)))))

マップタイプがサポートされていません。エラーをスローします。

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関数は配列パラメータを1つのみ受け取り、複数のパラメータを渡すとエラーが発生します。

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

array_distinct​

説明​

構文​

パラメータ​

戻り値​

例​

キーワード​

array_distinct

説明

構文

パラメータ

戻り値

例

キーワード