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

ARRAY_EXISTS

array_exists​

SinceVersion 2.0.0

説明​

配列の要素にラムダ式を適用し、各要素が条件を満たすかどうかを示す真偽値の配列を返します。配列の各要素にラムダ式を適用し、それぞれに対応する真偽値を返します。

構文​

array_exists(lambda, array1, ...)

パラメータ​

  • lambda：配列の要素を評価するラムダ式。true/false、または真偽値に変換できる式を返します
  • array1, ...：一つ以上の 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、MAP、STRUCT

戻り値​

戻り値の型：ARRAY

戻り値の意味：

  • 入力配列と同じ長さの真偽値の配列を返します。各位置には、対応する要素にラムダ式を適用した結果が入ります
  • NULL：ラムダ式がなく、配列の引数のみが NULL の場合

使用上の注意：

  • ラムダ式のパラメータ数は、配列の引数の数と一致する必要があります
  • 入力配列はすべて同じ長さである必要があります
  • 複数の配列や複合型の配列の評価に対応しています
  • 空の配列に対しては空の配列を返します。ラムダ式がなく、配列の引数のみが NULL の場合は NULL を返します。ラムダ式があり、配列が NULL の場合はエラーになります
  • ラムダ式では任意のスカラー式を使用できますが、集約関数は使用できません
  • ラムダ式から他の高階関数を呼び出せますが、戻り値の型には互換性が必要です
  • 配列要素が null の場合、その要素はラムダ式に渡されて処理されます。ラムダ式で null かどうかを確認できます

クエリ例：

浮動小数点数の配列で、各要素が 3 以上かどうかを確認します：

SELECT array_exists(x -> x >= 3, [1.1, 2.2, 3.3, 4.4, 5.5]);
+--------------------------------------------------+
| array_exists(x -> x >= 3, [1.1, 2.2, 3.3, 4.4, 5.5]) |
+--------------------------------------------------+
| [0, 0, 1, 1, 1]                                 |
+--------------------------------------------------+

文字列の配列で、各要素の長さが 2 を超えるかどうかを確認します：

SELECT array_exists(x -> length(x) > 2, ['a', 'bb', 'ccc', 'dddd', 'eeeee']);
+--------------------------------------------------+
| array_exists(x -> length(x) > 2, ['a', 'bb', 'ccc', 'dddd', 'eeeee']) |
+--------------------------------------------------+
| [0, 0, 1, 1, 1]                                 |
+--------------------------------------------------+

空の配列に対しては空の配列を返します：

SELECT array_exists(x -> x > 0, []);
+-------------------------------------+
| array_exists(x -> x > 0, [])       |
+-------------------------------------+
| []                                  |
+-------------------------------------+

NULL 配列とラムダ式の組み合わせです。ラムダ式があり、配列が NULL の場合はエラーになります。ラムダ式がない場合は NULL を返します：

SELECT array_exists(NULL);
+--------------------+
| array_exists(NULL) |
+--------------------+
| NULL               |
+--------------------+

SELECT array_exists(x -> x > 2, NULL);
ERROR 1105 (HY000): errCode = 2, detailMessage = lambda argument must be array but is NULL

null 値を含む配列では、ラムダ式で null かどうかを確認できます： null との比較演算（>、<、=、>=、<= など）は、特別な IS NULL または IS NOT NULL を除き、null を返します。未知の値（NULL）が 2 より大きいかどうかは判断できないためです。この動作は MySQL や PostgreSQL などと同じです。

SELECT array_exists(x -> x is not null, [1, null, 3, null, 5]);
+------------------------------------------+
| array_exists(x -> x is not null, [1, null, 3, null, 5]) |
+------------------------------------------+
| [1, 0, 1, 0, 1]                          |
+------------------------------------------+

SELECT array_exists(x -> x > 2, [1, null, 3, null, 5]);
+-------------------------------------------------+
| array_exists(x -> x > 2, [1, null, 3, null, 5]) |
+-------------------------------------------------+
| [0, null, 1, null, 1]                           |
+-------------------------------------------------+

複数の配列を評価し、最初の配列の各要素が次の配列の対応する要素より大きいかどうかを確認します：

SELECT array_exists((x, y) -> x > y, [1, 2, 3, 4, 5], [1.1, 2.2, 3.3, 4.4, 5.5]);
+--------------------------------------------------------+
| array_exists((x, y) -> x > y, [1, 2, 3, 4, 5], [1.1, 2.2, 3.3, 4.4, 5.5]) |
+--------------------------------------------------------+
| [0, 0, 0, 0, 0]                                       |
+--------------------------------------------------------+

複合型の例：

ネストした配列を評価し、各サブ配列の長さが 2 を超えるかどうかを確認します：

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

マップ型を評価し、キー 'a' に対応する値が 10 を超えるかどうかを確認します：

SELECT array_exists(x -> x['a'] > 10, [{'a':5}, {'a':15}, {'a':20}]);
+---------------------------------------------------------------+
| array_exists(x -> x['a'] > 10, [{'a':5}, {'a':15}, {'a':20}]) |
+---------------------------------------------------------------+
| [0, 1, 1]                                                     |
+---------------------------------------------------------------+

ラムダ式のパラメータ数が配列の引数の数と一致しない場合はエラーになります：

SELECT array_exists(x -> x > 0, [1,2,3], [4,5,6], [7,8,9]);
ERROR 1105 (HY000): errCode = 2, detailMessage = lambda x -> (x > 0) arguments' size is not equal parameters' size

配列の長さが一致しない場合はエラーになります：

SELECT array_exists((x, y) -> x > y, [1,2,3], [4,5]);
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.6)[INVALID_ARGUMENT]in array map function, the input column size are not equal completely, nested column data rows 1st size is 3, 2th size is 2.

配列以外の型を渡すとエラーになります：

SELECT array_exists(x -> x > 0, 'not_an_array');
ERROR 1105 (HY000): errCode = 2, detailMessage = lambda argument must be array but is 'not_an_array'

キーワード​

ARRAY, EXISTS, ARRAY_EXISTS

Report issue