ARRAY_REMOVE_FIRST

新增或更新于：v1.2.762

从数组中移除第一个出现的指定元素。

语法

ARRAY_REMOVE_FIRST(array, element)

参数

参数	说明
array	要从中移除元素的源数组。
element	要从数组中移除的元素。

返回类型

返回移除了首个指定元素的数组。

注意事项

此函数适用于标准数组类型和 variant 数组类型。

示例

示例 1：从标准数组中移除

SELECT ARRAY_REMOVE_FIRST([1, 2, 2, 3], 2);

结果：

[1, 2, 3]

示例 2：从 Variant 数组中移除

SELECT ARRAY_REMOVE_FIRST(PARSE_JSON('["apple", "banana", "apple", "orange"]'), 'apple');

结果：

["banana", "apple", "orange"]

示例 3：未找到元素

SELECT ARRAY_REMOVE_FIRST([1, 2, 3], 4);

结果：

[1, 2, 3]