Todos os produtos
Search
Central de documentação

ApsaraDB RDS:ST_ComputeStatistics

Última atualização: Sep 02, 2026

Calcula todas as estatísticas de um raster, incluindo histograma e percentis.

Sintaxe

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

raster ST_ComputeStatistics(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

Indica se a amostragem aproximada deve ser usada. Se definido como true, a amostragem será aplicada, mas o resultado poderá ser impreciso.

factor

integer

4

Fator de amostragem, expresso em pixels por unidade de amostragem. Aceita qualquer inteiro positivo. Aplica-se apenas quando approx for true.

exclusive_nodata

Boolean

true

Define 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 default settings.
UPDATE raster_table SET raster_obj = ST_ComputeStatistics(raster_obj) WHERE id = 1;

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

-- Disable approximate sampling without specifying bands.
UPDATE raster_table SET raster_obj = ST_ComputeStatistics(rast,'{"approx":false}') WHERE id = 1;

-- Specify bands, enable approximate sampling with a custom factor, and set the degree of parallelism.
UPDATE raster_table SET raster_obj = ST_ComputeStatistics(raster_obj,'0-2','{"approx":true, "factor":5}', '{"parallel":4}') WHERE id = 1;