Raster参考的属性的查询与更新函数ST_BuildPercentiles_云数据库 RDS(RDS)-阿里云帮助中心

计算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_obj	Raster对象。
sampleOption	基于JSON字符串的采样选项。更多信息，请参见sampleOption。
bands	指定的波段序号，从`0`开始，格式类似`'0,1-3,6,8'`的形式, `''`表示所有的波段。
parallelOption	基于JSON字符串的并行操作选项。更多信息，请参见parallelOption。

sampleOption说明：

参数名称	类型	默认值	描述
approx	boolean	false	是否使用采样方式计算。取值：[true\|false] 说明如果为true，则采用采样方式计算统计值，结果可能会不精确。
factor	integer	4	采样方式计算时使用的采样因子。取值为正整数。表示将n个象元作为一个采样单元。说明仅在approx为true时有效。
exclusive_nodata	boolean	true	是否不统计nodata数据。取值：[true\|false]

parallelOptions是基于JSON格式的字符串，用于描述操作选项。支持的参数如下：

参数名称	描述	类型	默认值	说明
parallel	操作并行度。	integer	ganos.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;