すべてのプロダクト
Search
ドキュメントセンター

PolarDB:ST_ComputeStatistics

最終更新日:Jul 02, 2024

この関数は、ラスターに関するすべての統計を収集するために使用されます。 統計には、ヒストグラムとパーセンタイルが含まれます。

構文

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

パラメーター

パラメーター

説明

raster_obj

クエリするラスター。The raster that you want to query.

sampleOption

サンプリングオプションで構成されるJSON文字列。 詳細については、このトピックの「sampleOption」表を参照してください。

bands

バンドのID。 例: '0,1-3,6,8 ' 有効なバンドIDは0から始まります。 このパラメーターを "に設定すると、ラスターのすべてのバンドが指定されます。

parallelOption

並列操作オプションで構成されるJSON文字列。 詳細については、このトピックの「parallelOption」の表を参照してください。

次の表に、sampleOptionパラメーターのパラメーターを示します。

パラメーター

データ型

デフォルト値

説明

approx

Boolean

false

サンプリング方法を使用するかどうかを指定します。 有効な値は、true および false です。

説明

このパラメーターをtrueに設定すると、サンプリング方法が使用されます。 この場合、返された結果は不正確になる可能性があります。

factor

integer

4

サンプリング方法が使用されるときに使用されるサンプリング係数。 有効値: 任意の正の整数。 サンプリング係数は、サンプリング単位として使用されるピクセルの数を指定します。

説明

このパラメーターは、approxパラメーターをtrueに設定した場合にのみ有効です。

exclusive_nodata

Boolean

true

NoData値を含めるかどうかを指定します。 有効な値は、true および false です。

次の表に、parallelOptionパラメーターのパラメーターを示します。

パラメーター

説明

データ型

デフォルト値

補足

parallel

許可されている並列処理の程度。

integer

ganos.parallel.degree

有効な値: 1 ~ 64。

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

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

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

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