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

ApsaraDB RDS:ST_BuildPercentiles

最終更新日:Mar 29, 2026

ラスターオブジェクト内の指定されたバンドのパーセンタイルを計算します。

構文

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

raster ST_BuildPercentiles(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_BuildPercentiles(raster_obj) WHERE id = 1;

-- バンドとサンプリング方法を指定します。
UPDATE raster_table SET raster_obj = ST_BuildPercentiles(rast,'0-2','{"approx":false}') WHERE id = 1;

-- サンプリング方法を指定します。
UPDATE raster_table SET raster_obj = ST_BuildPercentiles(rast,'{"approx":false}') WHERE id = 1;

-- バンド、サンプリングレート、および並列処理の次数を指定します。
UPDATE raster_table SET raster_obj = ST_BuildPercentiles(raster_obj,'0-2','{"approx":true, "factor":5}', '{"parallel":4}') WHERE id = 1;