ARRAY_POSITION - MaxCompute - Centro de documentación de Alibaba Cloud

Calcula la posición de la primera aparición del elemento element en el arreglo ARRAY a. La numeración de las posiciones de los elementos del arreglo ARRAY comienza en 1 y se cuenta de izquierda a derecha.

Formato del comando

bigint array_position(array<T> <a>, T <element>)

Descripción de parámetros

a: obligatorio. Arreglo ARRAY. El valor array<T> en T indica el tipo de datos de los elementos del arreglo ARRAY. Los tipos de datos admitidos son los siguientes:
- TINYINT, SMALLINT, INT, BIGINT
- FLOAT, DOUBLE
- BOOLEAN
- DECIMAL, DECIMALVAL
- DATE, DATETIME, TIMESTAMP, IntervalDayTime, IntervalYearMonth
- STRING, BINARY, VARCHAR, CHAR
- ARRAY, STRUCT, MAP
element: obligatorio. Elemento a consultar. Su tipo de datos debe coincidir con el de los elementos en a.

Descripción del valor de retorno

Devuelve un valor de tipo BIGINT. Las reglas de retorno son las siguientes:

Si el arreglo ARRAY a o element es NULL, devuelve NULL.
Devuelve 0 si no se encuentra el elemento.

Ejemplos de uso

Ejemplo 1: calcular la posición de la primera aparición del elemento 1 en el arreglo ARRAY array(3, 2, 1). Comando de ejemplo:
```
--返回3。
select array_position(array(3, 2, 1), 1);
```

Ejemplo 2: element es NULL. Comando de ejemplo:

--返回NULL。
select array_position(array(3, 1, null), null);

Funciones relacionadas

La función ARRAY_POSITION pertenece a las funciones de tipos complejos. Para obtener más información sobre las funciones de procesamiento de datos de tipos complejos (como datos ARRAY, MAP, STRUCT y JSON), consulte Complex type functions.