ARRAY_INDEXOF

引入或更新于：v1.2.762

返回数组中某个元素首次出现的索引。

语法

ARRAY_INDEXOF(array, element)

参数

参数	描述
array	待搜索的数组。
element	要搜索的元素。

返回类型

整数（INTEGER）

关于索引的重要说明

• 对于标准数组类型 (Standard Array Types)：索引是从 1 开始的（第一个元素的位置是 1）。
• 对于 VARIANT 数组类型：索引是从 0 开始的（第一个元素的位置是 0），以兼容 Snowflake。

示例

示例 1：在标准数组中查找元素（索引从 1 开始）

SELECT ARRAY_INDEXOF([10, 20, 30, 20], 20);

结果：

2

示例 2：在 VARIANT 数组中查找元素（索引从 0 开始）

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

结果：

1

示例 3：未找到元素

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

结果：

0