全部產品
Search
文件中心

PolarDB:ST_BuildPercentiles

更新時間:Jul 06, 2024

計算raster對象中指定波段集的百分比資訊。

文法

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

參數

參數名稱描述
raster_objRaster對象。
sampleOption基於JSON字串的採樣選項。更多資訊,請參見sampleOption
bands指定的波段序號,從0開始,格式類似'0,1-3,6,8'的形式, ''表示所有的波段。
parallelOption基於JSON字串的並行操作選項。更多資訊,請參見parallelOption
sampleOption說明:
參數名稱類型預設值描述
approxbooleanfalse是否使用採樣方式計算。取值:[true|false]
說明 如果為true,則採用採樣方式計算統計值,結果可能會不精確。
factorinteger4採樣方式計算時使用的採樣因子。取值為正整數。表示將n個象元作為一個採樣單元。
說明 僅在approx為true時有效。
exclusive_nodatabooleantrue是否不統計nodata資料。取值:[true|false]

parallelOptions是基於JSON格式的字串,用於描述操作選項。支援的參數如下:

參數名稱描述類型預設值說明
parallel操作並行度。integerganos.parallel.degree並行度範圍為1~64。

樣本

-- 預設
UPDATE raster_table SET raster_obj = ST_BuildPercentiles(raster_obj) WHERE id = 1;

-- 指定波段和採樣方式
UPDATE raster_table SET raster_obj = ST_BuildPercentiles(rast,'0-2','{"approx":false}') WHERE id = 1;

-- 指定採樣方式
UPDATE raster_table SET raster_obj = ST_BuildPercentiles(rast,'{"approx":false}') WHERE id = 1;

-- 指定波段、採樣率和並行度
UPDATE raster_table SET raster_obj = ST_BuildPercentiles(raster_obj,'0-2','{"approx":true, "factor":5}', '{"parallel":4}') WHERE id = 1;