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

ARRAY_COUNT

array_count​

SinceVersion 2.0.0

説明​

配列の要素にラムダ式を適用し、戻り値が 0 ではない要素の数を返します。

構文​

array_count(lambda, array1, ...)

引数​

  • lambda：配列の要素を評価および計算するためのラムダ式
  • array1, ...：一つ以上の ARRAY<T> 型の引数

T でサポートされる型：

  • 数値型：TINYINT、SMALLINT、INT、BIGINT、LARGEINT、FLOAT、DOUBLE、DECIMAL
  • 文字列型：CHAR、VARCHAR、STRING
  • 日付・時刻型：DATE、DATETIME、DATEV2、DATETIMEV2
  • 真偽値型：BOOLEAN
  • IP 型：IPV4、IPV6
  • 複合データ型：ARRAY、MAP、STRUCT

戻り値​

戻り値の型：BIGINT

戻り値の意味：

  • ラムダ式の結果が true になる要素の数を返します
  • 0：条件を満たす要素がない場合、または入力配列が NULL の場合

使用上の注意：

  • ラムダ式の引数の数は、配列の引数の数と一致する必要があります
  • すべての入力配列の長さは同じである必要があります
  • 複数の配列や複合型の配列を対象に数を数えられます
  • 空の配列の場合は 0、NULL の配列の場合も 0 を返します
  • ラムダ式から別の高階関数を呼び出せますが、戻り値の型に互換性が必要です
  • 配列の要素に NULL が含まれる場合、その要素は処理のためにラムダ式に渡され、ラムダ式で NULL を評価できます

例​

CREATE TABLE array_count_test (
    id INT,
    int_array ARRAY<INT>,
    double_array ARRAY<DOUBLE>,
    string_array ARRAY<STRING>
)
DUPLICATE KEY(id)
DISTRIBUTED BY HASH(id) BUCKETS 3
PROPERTIES (
    "replication_num" = "1"
);

INSERT INTO array_count_test VALUES
(1, [1, 2, 3, 4, 5], [1.1, 2.2, 3.3, 4.4, 5.5], ['a', 'bb', 'ccc', 'dddd', 'eeeee']),
(2, [1, null, 3, null, 5], [1.1, null, 3.3, null, 5.5], ['a', null, 'ccc', null, 'eeeee']),
(3, [], [], []),
(4, NULL, NULL, NULL);

クエリ例：

int_array 内の 2 より大きい要素の数を数える：

SELECT array_count(x -> x > 2, int_array) FROM array_count_test WHERE id = 1;
+-------------------------------------+
| array_count(x -> x > 2, int_array)  |
+-------------------------------------+
|                                   3 |
+-------------------------------------+

double_array 内の 3 以上の要素の数を数える：

SELECT array_count(x -> x >= 3, double_array) FROM array_count_test WHERE id = 1;
+------------------------------------------+
| array_count(x -> x >= 3, double_array)   |
+------------------------------------------+
|                                        3 |
+------------------------------------------+

string_array 内の長さが 2 を超える要素の数を数える：

SELECT array_count(x -> length(x) > 2, string_array) FROM array_count_test WHERE id = 1;
+--------------------------------------------------+
| array_count(x -> length(x) > 2, string_array)    |
+--------------------------------------------------+
|                                              3   |
+--------------------------------------------------+

空の配列を計算する場合：

SELECT array_count(x -> x > 0, int_array) FROM array_count_test WHERE id = 3;
+-------------------------------------+
| array_count(x -> x > 0, int_array)  |
+-------------------------------------+
|                                   0 |
+-------------------------------------+

NULL の配列を計算する場合：

SELECT array_count(x -> x > 0, int_array) FROM array_count_test WHERE id = 4;
+-------------------------------------+
| array_count(x -> x > 0, int_array)  |
+-------------------------------------+
|                                   0 |
+-------------------------------------+

NULL を含む配列で、NULL の要素の数を数える：

SELECT array_count(x -> x is null, int_array) FROM array_count_test WHERE id = 2;
+------------------------------------------+
| array_count(x -> x is null, int_array)   |
+------------------------------------------+
|                                        2 |
+------------------------------------------+

NULL を含む配列で、NULL ではない要素の数を数える：

SELECT array_count(x -> x is not null, int_array) FROM array_count_test WHERE id = 2;
+----------------------------------------------+
| array_count(x -> x is not null, int_array)   |
+----------------------------------------------+
|                                            3 |
+----------------------------------------------+

複数の配列を引数に指定する例：

SELECT array_count((x, y) -> x > y, [1, 2, 3], [0, 3, 2]);
+--------------------------------------------------+
| array_count((x, y) -> x > y, [1, 2, 3], [0, 3, 2]) |
+--------------------------------------------------+
|                                              2   |
+--------------------------------------------------+

複合型の例：要素が 2 つより多い配列の数を数える：

SELECT array_count(x -> array_size(x) > 2, [[1,2],[1,2,3],[4,5,6,7]]);
+----------------------------------------------------------------+
| array_count(x -> array_size(x) > 2, [[1,2],[1,2,3],[4,5,6,7]]) |
+----------------------------------------------------------------+
|                                                              2 |
+----------------------------------------------------------------+

高階関数のネスト：array_count に渡すラムダ式の本体は、BOOLEAN にキャストできるスカラー値を返す必要があります。内側の array_exists が（内側の要素ごとに一つの）真偽値の ARRAY を返す場合、array_count はその値を受け取れず、シグネチャエラーを報告します：

SELECT array_count(x -> array_exists(y -> y > 5, x), [[1,2,3],[4,5,6],[7,8,9]]);
ERROR 1105 (HY000): errCode = 2, detailMessage = Can not find the compatibility function signature: array_count(ARRAY<ARRAY<BOOLEAN>>)

5 より大きい要素を一つでも含む外側の配列の数を数えるには、ラムダ式がスカラーの BOOLEAN を返すように内側の判定を包みます。たとえば、size(array_filter(y -> y > 5, x)) > 0 を使用します：

SELECT array_count(x -> size(array_filter(y -> y > 5, x)) > 0, [[1,2,3],[4,5,6],[7,8,9]]);
+----------------------------------------------------------------------------------+
| array_count(x -> size(array_filter(y -> y > 5, x)) > 0, [[1,2,3],[4,5,6],[7,8,9]]) |
+----------------------------------------------------------------------------------+
|                                                                                2 |
+----------------------------------------------------------------------------------+

配列リテラルの例：

SELECT array_count(x -> x % 2 = 0, [1, 2, 3, 4, 5, 6]);
+------------------------------------------+
| array_count(x -> x % 2 = 0, [1, 2, 3, 4, 5, 6]) |
+------------------------------------------+
|                                        3 |
+------------------------------------------+

キーワード​

ARRAY, COUNT, ARRAY_COUNT

Report issue