全部产品
Search
文档中心

MaxCompute:SLICE

更新时间:Jul 02, 2025

Menyalin elemen-elemen dalam array dari posisi start berdasarkan panjang tertentu dan mengembalikan elemen-elemen tersebut sebagai array baru.

Sintaksis

array<T> slice(array<T> <a>, <start>, <length>)

Parameter

  • a: Wajib. Menentukan array. T dalam array<T> menunjukkan tipe data elemen-elemen dalam array, yang dapat berupa tipe apa pun.

  • start: Wajib. Parameter ini menentukan posisi awal untuk menyalin elemen dari kiri ke kanan. Nilai positif minimum untuk parameter ini adalah 1. Anda juga dapat menetapkan nilai negatif untuk parameter start. Dalam hal ini, posisi awal dihitung dari akhir array, tetapi elemen-elemen tetap disalin dari kiri ke kanan.

  • length: Wajib. Menentukan jumlah elemen dalam array hasil. Nilainya harus lebih besar dari atau sama dengan 0. Jika nilainya melebihi panjang array input, fungsi akan mengembalikan array baru yang mencakup elemen-elemen dari posisi start hingga akhir array input.

Nilai pengembalian

Mengembalikan nilai bertipe ARRAY.

Contoh

  • Contoh 1: Menyalin elemen-elemen dalam array(10, 20, 20, null, null, 30) dari posisi 1 dengan panjang 3. Pernyataan contoh:

    -- Nilai pengembalian adalah [10, 20, 20]. 
    select slice(array(10, 20, 20, null, null, 30), 1, 3);
  • Contoh 2: Menyalin elemen-elemen dalam array(10, 20, 20, null, null, 30) dari posisi -2 dengan panjang 2. Pernyataan contoh:

    -- Nilai pengembalian adalah [null, 30]. 
    select slice(array(10, 20, 20, null, null, 30), -2, 2);  
  • Contoh 3: Menyalin elemen-elemen dalam array(10, 20, 20, null, null, 30) dari posisi 3 dengan panjang 10. Pernyataan contoh:

    -- Nilai pengembalian adalah [20, null, null, 30]. 
    select slice(array(10, 20, 20, null, null, 30), 3, 10); 
  • Contoh 4: Menyalin elemen-elemen dalam array(10, 20, 20, null, null, 30) dari posisi 3 dengan panjang 0. Pernyataan contoh:

    -- Nilai pengembalian adalah []. 
    select slice(array(10, 20, 20, null, null, 30), 3, 0);

Fungsi terkait

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