Todos los productos
Search

Este producto

    MaxCompute:ARRAY_REMOVE

    Centro de documentos

    MaxCompute:ARRAY_REMOVE

    Última actualización: Sep 22, 2026

    Elimina un element específico del arreglo a.

    Sintaxis

    array<T> array_remove(array<T> <a>, T <element>)

    Parámetros

    • a: obligatorio. Este parámetro especifica un arreglo. T en array<T> indica el tipo de dato de los elementos del arreglo. A continuación se muestran los tipos de dato compatibles:

      • TINYINT, SMALLINT, INT y BIGINT

      • FLOAT y DOUBLE

      • BOOLEAN

      • DECIMAL y DECIMALVAL

      • DATE, DATETIME, TIMESTAMP, IntervalDayTime e IntervalYearMonth

      • STRING, BINARY, VARCHAR y CHAR

      • ARRAY, STRUCT y MAP

    • element: obligatorio. El elemento que desea eliminar. El tipo de dato de este parámetro debe coincidir con el de los elementos del arreglo a.

    Valor devuelto

    Se devuelve un valor de tipo ARRAY. El resultado varía según las siguientes reglas:

    • Si algún elemento del arreglo a es null, dicho elemento no participa en la operación.

    • Si el arreglo a o element es null, se devuelve null.

    • Si el arreglo a no contiene el element especificado, se devuelve el mismo arreglo a.

    Ejemplos

    • Ejemplo 1: elimine 1 de array(3, 2, 1). Instrucción de ejemplo:

      -- The return value is [3,2]. 
select array_remove(array(3, 2, 1), 1);

    • Ejemplo 2: el element especificado es null. Instrucción de ejemplo:

      -- The return value is null. 
select array_remove(array(3, 1, null), null);

    • Ejemplo 3: elimine 2 de array(3, 1, null). Instrucción de ejemplo:

      -- The return value is [3,1,null]. 
select array_remove(array(3, 1, null), 2);

    Funciones relacionadas

    ARRAY_REMOVE es una función de tipo complejo. Para obtener más información sobre las funciones que procesan datos de tipos complejos, como ARRAY, MAP, STRUCT y JSON, consulte Complex type functions.