All Products
Search
Document Center

PolarDB:ST_ChunkBands

Last Updated:Mar 28, 2026

Returns the number of bands per chunk (tile) of a raster object.

Syntax

integer ST_ChunkBands(raster raster_obj)

Parameters

ParameterDescription
raster_objThe name of the raster object.

Description

ST_ChunkBands returns the band count of a single chunk in the raster object's chunk storage layout. Use ST_ChunkBands to inspect how a raster is chunked—for example, to verify that the chunk band count matches your expected configuration.

Examples

Query the chunk band count for all rows in a raster table:

SELECT ST_ChunkBands(rast)
FROM raster_table;
 st_chunkbands
----------
      3