Todos os produtos
Search

Este produto

    MaxCompute:ARRAY_REMOVE

    Central de documentação

    MaxCompute:ARRAY_REMOVE

    Última atualização: Sep 22, 2026

    Remove um determinado element do Array a.

    Sintaxe

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

    Parâmetros

    • a: obrigatório. Especifica um array. T em array<T> indica o tipo de dados dos elementos no array. Os seguintes tipos de dados são compatíveis:

      • TINYINT, SMALLINT, INT e BIGINT

      • FLOAT e DOUBLE

      • BOOLEAN

      • DECIMAL e DECIMALVAL

      • DATE, DATETIME, TIMESTAMP, IntervalDayTime e IntervalYearMonth

      • STRING, BINARY, VARCHAR e CHAR

      • ARRAY, STRUCT e MAP

    • element: obrigatório. O elemento a ser removido. O tipo de dados deste parâmetro deve ser igual ao tipo de dados dos elementos no Array a.

    Valor de retorno

    Retorna um valor do tipo ARRAY. O valor de retorno varia de acordo com as seguintes regras:

    • Se um elemento no Array a for null, o elemento null não participa da operação.

    • Se o Array a ou element for null, o retorno será null.

    • Caso o Array a não contenha o element especificado, a função retorna o Array a.

    Exemplos

    • Exemplo 1: Remova 1 de array(3, 2, 1). Instrução de exemplo:

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

    • Exemplo 2: O element especificado é null. Instrução de exemplo:

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

    • Exemplo 3: Remova 2 de array(3, 1, null). Instrução de exemplo:

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

    Funções relacionadas

    ARRAY_REMOVE é uma função de tipo complexo. Para obter mais informações sobre as funções usadas para processar dados de tipos complexos, como ARRAY, MAP, STRUCT e JSON, consulte Complex type functions.