All Products
Search
Document Center

ApsaraDB RDS:ST_ComputeStatistics

Last Updated:Mar 30, 2026

Menghitung seluruh statistik untuk raster, termasuk histogram dan persentil.

Sintaksis

raster ST_ComputeStatistics(raster raster_obj,
                            cstring sampleOption default '{}')

raster ST_ComputeStatistics(raster raster_obj,
                            cstring bands,
                            cstring sampleOption default '{}',
                            cstring parallelOption default '{}')

Parameter

ParameterDeskripsi
raster_objObjek raster.
bandsID band yang akan diproses. Contoh: '0,1-3,6,8'. ID band dimulai dari 0. Untuk memproses semua band, atur parameter ini ke ''.
sampleOptionString JSON berisi opsi pengambilan sampel. Lihat tabel parameter sampleOption. Nilai default-nya adalah '{}'.
parallelOptionString JSON berisi opsi eksekusi paralel. Lihat tabel parameter parallelOption. Nilai default-nya adalah '{}'.

Parameter sampleOption

ParameterTipeDefaultDeskripsi
approxBooleanfalseMenentukan apakah akan menggunakan pengambilan sampel perkiraan. Jika diatur ke true, pengambilan sampel diterapkan tetapi hasilnya mungkin tidak akurat.
factorinteger4Faktor pengambilan sampel, dinyatakan sebagai jumlah piksel per unit sampel. Semua bilangan bulat positif valid. Parameter ini hanya berlaku ketika approx bernilai true.
exclusive_nodataBooleantrueMenentukan apakah nilai NoData disertakan. Nilai yang valid: true dan false.

Parameter parallelOption

ParameterTipeDefaultDeskripsi
parallelintegerganos.parallel.degreeTingkat paralelisme. Nilai yang valid: 1 hingga 64.

Contoh

-- Gunakan pengaturan default.
UPDATE raster_table SET raster_obj = ST_ComputeStatistics(raster_obj) WHERE id = 1;

-- Tentukan band dan nonaktifkan pengambilan sampel perkiraan.
UPDATE raster_table SET raster_obj = ST_ComputeStatistics(rast,'0-2','{"approx":false}') WHERE id = 1;

-- Nonaktifkan pengambilan sampel perkiraan tanpa menentukan band.
UPDATE raster_table SET raster_obj = ST_ComputeStatistics(rast,'{"approx":false}') WHERE id = 1;

-- Tentukan band, aktifkan pengambilan sampel perkiraan dengan faktor kustom, dan atur tingkat paralelisme.
UPDATE raster_table SET raster_obj = ST_ComputeStatistics(raster_obj,'0-2','{"approx":true, "factor":5}', '{"parallel":4}') WHERE id = 1;