このトピックでは、ST_SubRaster関数について説明します。 この関数は、ラスタオブジェクトのピラミッドレベルまたはバンドを変換します。
構文
ラスターST_SubRaster(raster raster_obj,
integer pyramidLevel default 0,
cstring bands default '', /* All bands */
cstringstorageOptionデフォルト '')
パラメーター
パラメーター | 説明 |
raster_obj | ピラミッドレベルまたはバンドを変換する元のラスターオブジェクト。 |
pyramidLevel | 変換するピラミッドレベル。 |
バンド | あなたが変換したいバンド。 このフィールドの値は、整数の配列または0から始まる整数の範囲にすることができます。 例: 「0-2」および「1,2、3」。 デフォルト値は null 文字列 ('') です。 デフォルト値では、すべてのバンドを変換します。 |
storageOption | 新しいラスターオブジェクトを格納する方法を指定するJSON文字列。 |
次の表に、storageOptionパラメーターのフィールドを示します。
フィールド | 説明 | データ型 | デフォルト値 | 設定ノート |
チャンキング | 新しいラスターオブジェクトをチャンクとして保存するかどうかを指定します。 | Boolean | 元のラスターオブジェクトと同じ | N/A |
chunkdim | 新しいラスタオブジェクトをチャンクとして格納するために使用されるディメンション。 | String | 元のラスターオブジェクトと同じ | このフィールドは、チャンキングフィールドがtrueに設定されている場合にのみ有効です。 |
chunktable | チャンクテーブルの名前です。 | String | null 文字列 (") | デフォルトでは、データを格納するためにランダムな名前の一時チャンクテーブルが生成されます。 この一時チャンクテーブルは、現在のセッションでのみ有効です。 新しいラスターオブジェクトを永続的に保存するには、chunktableフィールドに永続チャンクテーブルを作成するように指定する必要があります。 |
compression | 画像圧縮に使用される形式。 | String | 元のラスターオブジェクトと同じ | None、JPEG、Zlib、PNG、LZO、LZ4の6つの圧縮形式がサポートされています。 |
品質 | 新しいラスターオブジェクトの画質。 | Integer | 元のラスターオブジェクトと同じ | このフィールドはJPEG形式でのみ有効です。 |
interleaving | 新しいラスタオブジェクトのインターリーブタイプ。 | String | 元のラスターオブジェクトと同じ | 有効な値:
|
エンディアン | 新しいラスタオブジェクトのエンディアン形式。 | String | 元のラスターオブジェクトと同じ | 有効な値:
|
例
SELECT ST_SubRaster(rast, 1, '0-2 ', '{"chunktable":"chunk_table", "chunk_table":true}')
FROM raster_sub
WHERE id=1;