Sintaxe, parâmetros e exemplos de ST_SubRaster - ApsaraDB RDS: Central de Documentação do Alibaba Cloud

Sintaxe

raster ST_SubRaster(raster raster_obj,
                    integer pyramidLevel default 0,
                    cstring bands default '',
                    cstring storageOption default '',
                    cstring options default '{}')

Parâmetros

Parâmetro	Tipo	Padrão	Descrição
`raster_obj`	raster	—	Objeto raster de source.
`pyramidLevel`	integer	`0`	Nível da pirâmide a extrair.
`bands`	cstring	`''`	Bandas a extrair. Aceita um intervalo de inteiros (`'0-2'`) ou uma lista separada por vírgulas (`'1,2,3'`). Os índices das bandas começam em `0`. O valor padrão (`''`) extrai todas as bandas.
`storageOption`	cstring	`''`	String JSON que controla o armazenamento do novo objeto raster. Consulte storageOption parameters.
`options`	cstring	`'{}'`	String JSON que define a geração do novo objeto raster. Consulte options parameters.

Parâmetros de storageOption

Todos os subparâmetros de storageOption são opcionais. Parâmetros não especificados herdam o valor do objeto raster de source.

Parâmetros comuns

Parâmetro	Tipo	Padrão	Descrição
`chunktable`	string	`''`	Nome da tabela de chunks do novo objeto raster. Se defina como `''` ou `NULL`, o sistema cria uma tabela de chunks temporária com nome aleatório, válida apenas para a sessão atual. Especifique um nome para criar uma tabela de chunks permanente.
`compression`	string	Igual à source	Formato de compressão. Valores válidos: `NONE`, `JPEG`, `ZLIB`, `PNG`, `LZO`, `LZ4`.
`celltype`	string	Igual à source	Tipo de pixel. Valores válidos: `1bb`, `2bui`, `4bui`, `8bsi`, `8bui`, `16bsi`, `16bui`, `32bsi`, `32bui`, `64bsi`, `64bui`, `32bf`, `64bf`.
`chunking`	boolean	Igual à source	Define se o novo objeto raster será armazenado em chunks.

Parâmetros avançados

Parâmetro	Tipo	Padrão	Descrição
`chunkdim`	string	Igual à source	Dimensões dos chunks. Válido somente quando `chunking` for `true`.
`quality`	integer	Igual à source	Qualidade da imagem após compressão (1–99). Aplicável apenas se `compression` for `JPEG`.
`interleaving`	string	Igual à source	Tipo de intercalação. Valores válidos: `bip` (band interleaved by pixel, BIP), `bil` (band interleaved by line, BIL), `bsq` (band sequential, BSQ).
`endian`	string	Igual à source	Ordem dos bytes. Valores válidos: `NDR` (little-endian), `XDR` (big-endian).

Parâmetros de options

Parâmetro	Tipo	Padrão	Descrição
`parallel`	integer	ganos.parallel.degree	Grau de paralelismo. Valores válidos: 1–64.
`stretch`	string	`none`	Método de estiramento dos valores de pixel. Valores válidos: `none` (substitui valores fora do intervalo pelo extremo mais próximo), `stats` (estira com base nas estatísticas do raster; exige estatísticas pré-calculadas, veja a nota abaixo), `data_type` (estira conforme o intervalo de valores do tipo de pixel).

Quando stretch estiver definido como stats , o objeto raster de source deve ter estatísticas pré-calculadas. Execute ST_SummaryStats no objeto raster de source antes de chamar ST_SubRaster .

Exemplos

Extrair bandas de um objeto raster

Extraia as bandas de 0 a 2 do nível 1 da pirâmide e armazene o resultado em uma tabela de chunks permanente.

SELECT ST_SubRaster(rast, 1, '0-2', '{"chunktable":"chunk_table", "chunking":true}')
FROM raster_sub
WHERE id = 1;

Converter tipo de pixel e estirar valores em paralelo

Converta para inteiro sem sinal de 8 bits (8BUI) usando o estiramento data_type com paralelismo de 4.

SELECT ST_SubRaster(rast, 1, '0-2', '{"chunktable":"chunk_table", "chunking":true, "celltype": "8BUI"}', '{"stretch": "data_type", "parallel": 4}')
FROM raster_sub
WHERE id = 1;