メインコンテンツまでスキップ
バージョン: 26.x

ARRAY_ENUMERATE_UNIQ

array_enumerate_uniq​

説明​

配列内の各要素の一意な出現回数を返します。この関数は配列内の各要素に対して数値を生成し、その要素が配列内で何回出現したかを示します。

構文​

array_enumerate_uniq(ARRAY<T> arr1, [ARRAY<T> arr2, ...])

パラメータ​

  • arr1, arr2, ...：ARRAY 型、一意の番号を生成する配列。1つ以上の配列パラメータをサポートします。

T でサポートされる型:

  • 数値型: TINYINT, SMALLINT, INT, BIGINT, LARGEINT, FLOAT, DOUBLE, DECIMAL
  • 文字列型: CHAR, VARCHAR, STRING
  • 日付時刻型: DATE, DATETIME, DATEV2, DATETIMEV2
  • 真偽値型: BOOLEAN
  • IP 型: IPV4, IPV6

戻り値​

戻り値の型: ARRAY

戻り値の意味:

  • 入力配列と同じ長さの新しい配列を返し、各位置には配列内の対応する要素の一意出現回数番号が含まれます
  • NULL: 入力配列が NULL の場合

使用上の注意:

  • この関数は配列内の各要素に対して一意の番号を生成し、1から開始して増分します
  • 複数回出現する要素については、各出現に対して増分番号が割り当てられます
  • 複数の配列パラメータがある場合、すべての配列は同じ長さである必要があり、そうでなければエラーが発生します。複数配列の対応する位置が組み合わされて要素ペアを形成し、これが番号生成に使用されます
  • 空の配列は空の配列を返し、NULL 配列は NULL を返します
  • 配列要素内の null 値について: null 要素も対応する番号を生成します

クエリ例:

配列に対して一意の番号を生成します。複数回出現する要素については、各出現に対して増分番号が割り当てられます:

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

空の配列は空の配列を返します：

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

NULL配列はNULLを返します：

SELECT array_enumerate_uniq(NULL), array_enumerate_uniq(NULL, NULL);
+----------------------------+----------------------------------+
| array_enumerate_uniq(NULL) | array_enumerate_uniq(NULL, NULL) |
+----------------------------+----------------------------------+
| NULL                       | NULL                             |
+----------------------------+----------------------------------+

null値を含む配列では、null要素も数値を生成します：

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

複数の配列パラメータの例で、複数の配列の組み合わせに基づいて数値を生成します：

SELECT array_enumerate_uniq([1, 2, 1], [10, 20, 10]);
+----------------------------------------------+
| array_enumerate_uniq([1, 2, 1], [10, 20, 10]) |
+----------------------------------------------+
| [1, 1, 2]                                    |
+----------------------------------------------+

配列の長さが一致しない場合のエラー:

SELECT array_enumerate_uniq([1,2,3], [4,5]);
ERROR 1105 (HY000): errCode = 2, detailMessage = lengths of all arrays of function array_enumerate_uniq must be equal.

IPタイプサポート例:

SELECT array_enumerate_uniq(CAST(['192.168.1.1', '192.168.1.2', '192.168.1.1'] AS ARRAY<IPV4>));
+------------------------------------------------------------------------------------------+
| array_enumerate_uniq(CAST(['192.168.1.1', '192.168.1.2', '192.168.1.1'] AS ARRAY<IPV4>)) |
+------------------------------------------------------------------------------------------+
| [1, 1, 2]                                                                                |
+------------------------------------------------------------------------------------------+

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

複合型の例:

ネストした配列型はサポートされていません。エラーが発生します:

SELECT array_enumerate_uniq([[1,2],[3,4],[5,6]]);
ERROR 1105 (HY000): errCode = 2, detailMessage = array_enumerate_uniq does not support type ARRAY<ARRAY<TINYINT>>, expression is array_enumerate_uniq([[1, 2], [3, 4], [5, 6]])

Mapタイプはサポートされておらず、エラーになります：

SELECT array_enumerate_uniq([{'k':1},{'k':2},{'k':3}]);
ERROR 1105 (HY000): errCode = 2, detailMessage = array_enumerate_uniq does not support type ARRAY<MAP<VARCHAR(1),TINYINT>>, expression is array_enumerate_uniq([map('k', 1), map('k', 2), map('k', 3)])

パラメータ数が間違っている場合のエラー:

SELECT array_enumerate_uniq();
ERROR 1105 (HY000): errCode = 2, detailMessage = Can not found function 'array_enumerate_uniq' which has 0 arity. Candidate functions are: [array_enumerate_uniq(Expression, Expression...)]

非配列型を渡した場合のエラー:

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

キーワード​

ARRAY、ENUMERATE、UNIQ、ARRAY_ENUMERATE_UNIQ