All Products
Search
Document Center

ApsaraDB RDS:ST_SummaryStats

Last Updated:Mar 29, 2026

ST_SummaryStats menghitung statistik band untuk objek raster.

Sintaksis

raster ST_SummaryStats(raster raster_obj)
raster ST_SummaryStats(raster raster_obj, cstring statsOptions)
raster ST_SummaryStats(raster raster_obj, cstring bands, cstring statsOptions)

Parameter

ParameterDeskripsi
raster_objObjek raster yang akan dianalisis.
bandsBand yang akan disertakan, ditentukan sebagai array integer atau rentang. Indeks band dimulai dari 0. Contoh: '0', '1-3', '1,2,3'.
statsOptionsString JSON yang menentukan opsi perhitungan. Lihat bidang statsOptions di bawah.

bidang statsOptions

BidangTipeBawaanDeskripsi
approxbooleantrueMenentukan apakah akan menggunakan pengambilan sampel untuk menghitung statistik.
Secara default, approx bernilai true, yang menggunakan pengambilan sampel agar perhitungan statistik lebih cepat. Hasilnya mungkin sedikit tidak akurat. Atur approx ke false untuk memindai semua piksel dan mendapatkan statistik yang eksak.

Nilai kembalian

Mengembalikan objek raster dengan statistik yang disimpan per band.

Contoh

Hitung statistik untuk semua band menggunakan pengambilan sampel (default)

UPDATE raster_obj SET raster_obj = ST_SummaryStats(raster_obj) WHERE id = 1;

Hitung statistik eksak untuk rentang band tertentu

Berikan '{"approx":false}' untuk memindai semua piksel alih-alih menggunakan pengambilan sampel. Contoh berikut menghitung statistik eksak untuk band 0 hingga 2:

UPDATE rast SET rast = ST_SummaryStats(rast, '0-2', '{"approx":false}') WHERE id = 1;

Hitung statistik eksak untuk semua band

UPDATE rast SET rast = ST_SummaryStats(rast, '{"approx":false}') WHERE id = 1;