適用対象:
Databricks SQL
Databricks Runtime
array が value を含む場合は true を返します。
構文
array_contains(array, value)
引数
-
array: 検索対象のARRAY。 -
value: 最も一般的でない型をarray要素と共有する型を持つ式。
戻り値
BOOLEAN です。
value が NULL の場合、結果は NULL です。
array 内の要素が NULL の場合、NULL が他の要素と一致しなければ value です。
例
> SELECT array_contains(array(1, 2, 3), 2);
true
> SELECT array_contains(array(1, NULL, 3), 2);
NULL
> SELECT array_contains(array(1, 2, 3), NULL::INT);
NULL
-- You cannot test for a NULL value in an array using this function.
-- Use the exists function with a lambda instead.
> SELECT array_contains(array(1, 2, NULL, 3), NULL::INT);
NULL
> SELECT exists(array(1, 2, NULL, 3), x -> x IS NULL);
true
> SELECT exists(array(1, 2, 3), x -> x IS NULL);
false