All Products
Search

This Product

    MaxCompute:ARRAY_REMOVE

    Document Center

    MaxCompute:ARRAY_REMOVE

    Last Updated:Jul 02, 2025

    Menghapus elemen tertentu dari Array a.

    Sintaksis

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

    Parameter

    • a: Wajib. Menentukan sebuah array. T dalam array<T> menentukan tipe data elemen-elemen dalam array. Tipe data yang didukung meliputi:

      • TINYINT, SMALLINT, INT, dan BIGINT

      • FLOAT dan DOUBLE

      • BOOLEAN

      • DECIMAL dan DECIMALVAL

      • DATE, DATETIME, TIMESTAMP, IntervalDayTime, dan IntervalYearMonth

      • STRING, BINARY, VARCHAR, dan CHAR

      • ARRAY, STRUCT, dan MAP

    • element: Wajib. Elemen yang ingin dihapus. Tipe data parameter ini harus sesuai dengan tipe data elemen-elemen dalam Array a.

    Nilai kembali

    Mengembalikan nilai bertipe ARRAY. Nilai kembali bergantung pada aturan berikut:

    • Jika elemen dalam Array a adalah null, elemen tersebut tidak terlibat dalam operasi.

    • Jika Array a atau element bernilai null, maka hasilnya adalah null.

    • Jika Array a tidak mengandung element yang ditentukan, Array a dikembalikan tanpa perubahan.

    Contoh

    • Contoh 1: Menghapus 1 dari array(3, 2, 1). Pernyataan contoh:

      -- Nilai kembali adalah [3,2]. 
select array_remove(array(3, 2, 1), 1);

    • Contoh 2: Elemen yang ditentukan adalah null. Pernyataan contoh:

      -- Nilai kembali adalah null. 
select array_remove(array(3, 1, null), null);

    • Contoh 3: Menghapus 2 dari array(3, 1, null). Pernyataan contoh:

      -- Nilai kembali adalah [3,1,null]. 
select array_remove(array(3, 1, null), 2);

    Fungsi terkait

    ARRAY_REMOVE merupakan fungsi tipe kompleks. Untuk informasi lebih lanjut tentang fungsi-fungsi yang digunakan untuk memproses data dari tipe data kompleks seperti ARRAY, MAP, STRUCT, dan JSON, lihat Fungsi Tipe Kompleks.