array_position
関数
適用対象: Databricks SQL Databricks Runtime
element
で最初に見つかった array
の位置を返します。
構文
array_position(array, element)
引数
array
: 比較可能な要素を含む配列。element
:array
内の要素の型と一致する式。
戻り値
BIGINT
です。
配列のインデックスは 1 から始まります。 要素値が NULL
の場合は、NULL
が返されます。
配列内に要素が見つからない場合は、0 が返されます。
例
-- 1 exists twice. The function returns the first position
> SELECT array_position(array(3, 2, 1, 4, 1), 1);
3
-- this function cannot be used to find the position of a NULL element.
> SELECT array_position(array(3, NULL, 1), NULL)
NULL
> SELECT array_position(array(3, 2, 1), NULL)
NULL
-- The element is not found in the array
> SELECT array_position(array(3, 2, 1, 4, 1), 5)
0