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

ARRAY_ENUMERATE_UNIQ

array_enumerate_uniq​

SinceVersion 2.0.0

説明​

配列の各要素について、それまでに出現した回数を返します。配列の各要素に対して、その要素がそれまでに何回出現したかを示す数値を生成します。

構文​

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

パラメータ​

  • arr1, arr2, ...：ARRAY 型。各要素の出現回数を示す番号を生成する対象の配列です。配列パラメータは単一または複数指定できます。

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

戻り値の意味：

  • 入力配列と同じ長さの新しい配列を返します。各位置には、入力配列の対応する要素について、その位置までの出現回数が入ります
  • 入力配列が NULL の場合は NULL を返します

使用上の注意：

  • 配列の各要素について、1 から始まり、出現するたびに増加する番号を生成します
  • 同じ要素が複数回出現する場合、出現するたびに番号が増加します
  • 複数の配列パラメータを指定する場合、すべての配列の長さが同じである必要があります。異なる場合はエラーになります。複数の配列の対応する位置の要素を組み合わせ、その組に基づいて番号を生成します
  • 空の配列は空の配列を返し、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

Report issue