ST_BuildPercentiles - PolarDB - Alibaba Cloud ドキュメントセンター

この関数は、ラスターの指定されたバンドのパーセンタイルを計算するために使用されます。

構文

ラスターST_BuildPercentiles (ラスターraster_obj、 
                            cstring sampleOptionデフォルト '{}')
ラスターST_BuildPercentiles (ラスターraster_obj、 
                            cstringバンド、
                            cstring sampleOptionのデフォルト '{}' 、
                            cstring parallelOptionのデフォルト '{}')

パラメーター

パラメーター	説明
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パラメーターのパラメーターを示します。

パラメーター	データ型	デフォルト値	説明
約	Boolean	false	サンプリング方法を使用するかどうかを指定します。有効な値は、true および false です。説明このパラメーターをtrueに設定すると、サンプリング方法が使用されます。この場合、返された結果は不正確になる可能性があります。
要因	integer	4	サンプリング方法が使用されるときに使用されるサンプリング係数。有効値: 任意の正の整数。サンプリング係数は、サンプリング単位として使用されるピクセルの数を指定します。説明このパラメーターは、approxパラメーターをtrueに設定した場合にのみ有効です。
exclusive_nodata	Boolean	true	NoData値を含めるかどうかを指定します。有効な値は、true および false です。

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

パラメーター	説明	データ型	デフォルト値	補足
パラレル	許可されている並列処理の程度。	integer	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;