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

ApsaraDB RDS:ST_ComputeStatistics

最終更新日:Mar 29, 2026

ヒストグラムやパーセンタイルを含む、ラスタのすべての統計を計算します。

構文

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ラスタオブジェクト。
bandsプロセスするバンド ID。例:'0,1-3,6,8'。バンド ID は 0 から始まります。すべてのバンドをプロセスするには、このパラメーターを '' に設定します。
sampleOptionサンプリングオプションの JSON 文字列です。sampleOption パラメーターの表をご参照ください。デフォルトは '{}' です。
parallelOption並列実行オプションの JSON 文字列です。parallelOption パラメーターの表をご参照ください。デフォルトは '{}' です。

sampleOption パラメーター

パラメータータイプデフォルト説明
approxブール値false近似サンプリングを使用するかどうかを指定します。true に設定すると、サンプリングが適用されますが、結果が不正確になる可能性があります。
factor整数4サンプリングファクター。サンプリング単位あたりのピクセル数で表されます。任意の正の整数が有効です。このパラメーターは、approxtrue の場合にのみ適用されます。
exclusive_nodataブール値trueNoData 値を含めるかどうかを指定します。有効な値は `true` と `false` です。

parallelOption パラメーター

パラメータータイプデフォルト説明
parallel整数ganos.parallel.degree並列処理の次数。有効な値:1~64。

-- デフォルト設定を使用します。
UPDATE raster_table SET raster_obj = ST_ComputeStatistics(raster_obj) WHERE id = 1;

-- バンドを指定し、近似サンプリングを無効にします。
UPDATE raster_table SET raster_obj = ST_ComputeStatistics(rast,'0-2','{"approx":false}') WHERE id = 1;

-- バンドを指定せずに近似サンプリングを無効にします。
UPDATE raster_table SET raster_obj = ST_ComputeStatistics(rast,'{"approx":false}') WHERE id = 1;

-- バンドを指定し、カスタムファクターで近似サンプリングを有効にし、並列処理の次数を設定します。
UPDATE raster_table SET raster_obj = ST_ComputeStatistics(raster_obj,'0-2','{"approx":true, "factor":5}', '{"parallel":4}') WHERE id = 1;