ST_BuildPyramid - AnalyticDB

建立影像金字塔。

文法

raster ST_BuildPyramid(raster source, 
                       integer pyramidLevel default -1, 
                       ResampleAlgorithm algorithm default 'Near', 
                       cstring chunkTableName default '', 
                       cstring storageOption default '{}',
                       cstring buildOption default '{}');

參數

參數名稱	描述
source	需要建立金字塔的raster對象。
chunkTableName	金字塔所儲存的分塊表名稱。只對基於Object Storage Service的柵格對象有效。
pyramidLevel	金字塔建立的層級， -1表示建立到最高層級。
algorithm	建立金字塔的重採樣演算法，取值如下： Near：最鄰近 Average：平均值 Bilinear：二次線性 Cubic：三次卷積
storageOption	JSON字串，儲存選項。描述raster對象金字塔的分Block Storage資訊。該選項只針對基於Object Storage Service的柵格對象有效。
buildOption	JSON字串，構建選項。當前支援參數parallel，可以設定作業並行度，資料類型為Integer，取值範圍為1~64。不指定parallel時，使用GUC參數ganos.parallel.degree的值。說明如果啟用並行建立金字塔，則不支援事務。如果建立失敗或需要對交易回復，使用ST_deletePyramid刪除已經建立的金字塔。

storageOption參數說明如下。

參數名稱	類型	說明
chunkdim	string	分塊的維度資訊，格式為`(w, h, b)`，預設從原始影像中讀取分塊大小。
interleaving	string	交錯方式，取值如下： bip：像素交錯 bil：行交錯 bsq（預設值）：波段交錯 auto：根據原始影像自動選擇
compression	string	壓縮演算法類型，取值如下： none jpeg zlib png lzo lz4（預設值） zstd snappy jp2k
quality	integer	壓縮品質。只針對jpeg和jp2k壓縮演算法生效，預設值為75。

描述

建立金字塔支援GPU加速，如果運行環境帶有GPU裝置，則Ganos會自動開啟GPU加速功能。

樣本

DO $$
declare
    rast raster;
begin
    select raster_obj into rast from raster_table where id = 1;
    rast = st_buildpyramid(rast);
    update raster_table set raster_obj = rast where id = 1;
end;    
$$ LANGUAGE 'plpgsql';

DO $$
declare
    rast raster;
begin
    select raster_obj into rast from raster_table where id = 1;
    rast = st_buildpyramid(rast, 'chunk_table');
    update raster_table set raster_obj = rast where id = 1;
end;    
$$ LANGUAGE 'plpgsql';