array_contains 函数

适用于： 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

> SELECT array_contains(array(1, NULL, 3), 2);
 NULL

-- You canot test for a NULL value in an array using this function
> SELECT array_contains(array(1, 2, NULL, 3), NULL::INT);
 NULL

相关内容

• [ ]（方括号）运算符
• arrays_overlap 函数
• array_position 函数
• SQL 数据类型规则