ST_BuildPercentiles - ApsaraDB RDS: Central de Documentação do Alibaba Cloud

Sintaxe

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

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

Parâmetros

Parâmetro	Descrição
raster_obj	O objeto raster.
bands	IDs das bandas a processar. Exemplo: `'0,1-3,6,8'`. Os IDs das bandas começam em `0`. Para processar todas as bandas, defina este parâmetro como `''`.
sampleOption	String JSON com opções de amostragem. Consulte a tabela sampleOption parameters. O valor padrão é `'{}'`.
parallelOption	String JSON com opções de execução paralela. Consulte a tabela parallelOption parameters. O valor padrão é `'{}'`.

Parâmetros de sampleOption

Parâmetro	Tipo	Padrão	Descrição
approx	Boolean	false	Define se a amostragem aproximada deve ser usada. Se definido como `true`, a amostragem é aplicada, mas o resultado pode ser impreciso.
factor	integer	4	Fator de amostragem, expresso em pixels por unidade de amostragem. Qualquer inteiro positivo é válido. Este parâmetro aplica-se apenas quando `approx` é `true`.
exclusive_nodata	Boolean	true	Indica se os valores NoData devem ser incluídos. Valores válidos: true e false.

Parâmetros de parallelOption

Parâmetro	Tipo	Padrão	Descrição
parallel	integer	ganos.parallel.degree	Grau de paralelismo. Valores válidos: 1 a 64.

Exemplos

-- Use the default parameter settings.
UPDATE raster_table SET raster_obj = ST_BuildPercentiles(raster_obj) WHERE id = 1;

-- Specify the bands and the sampling method.
UPDATE raster_table SET raster_obj = ST_BuildPercentiles(rast,'0-2','{"approx":false}') WHERE id = 1;

-- Specify the sampling method.
UPDATE raster_table SET raster_obj = ST_BuildPercentiles(rast,'{"approx":false}') WHERE id = 1;

-- Specify the bands, sampling rate, and degree of parallelism.
UPDATE raster_table SET raster_obj = ST_BuildPercentiles(raster_obj,'0-2','{"approx":true, "factor":5}', '{"parallel":4}') WHERE id = 1;