この関数は、ラスターに関するすべての統計を収集するために使用されます。 統計には、ヒストグラムとパーセンタイルが含まれます。
構文
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。 例: |
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 | 有効な値: 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;