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

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

構文

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	クエリするラスター。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_BuildPercentiles(raster_obj) WHERE id = 1;

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

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

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