このトピックでは、ST_SubRaster関数について説明します。 この関数は、元のラスタオブジェクトの指定されたピラミッドレベルまたはバンドを新しいラスタオブジェクトに変換するために使用されます。
構文
ラスターST_SubRaster(raster raster_obj,
integer pyramidLevel default 0,
cstring bands default '',
cstring storageOption default ''、
cstringオプションのデフォルト '{}')
パラメーター
パラメーター | 説明 |
raster_obj | 元のラスタオブジェクトの名前。 |
pyramidLevel | 変換するピラミッドレベル。 |
バンド | 変換したいバンド。 このパラメーターの値は、整数の配列または整数の範囲にすることができます。 整数は0から始まります。 例: '0-2 ' および '1,2,3' デフォルト値:" デフォルト値では、すべてのバンドに基づいて新しいラスターオブジェクトを生成するように指定します。 |
storageOption | 新しいラスターオブジェクトを格納する方法を指定するJSON文字列。 詳細については、storageOptionパラメーターをご参照ください。 |
オプション | 新しいラスターオブジェクトを生成する方法を指定するJSON文字列。 詳細については、「options」パラメーターをご参照ください。 |
storageOptionパラメーターの値に含まれるパラメーターを次の表に示します。
パラメーター | 説明 | データ型 | デフォルト値 | 補足 |
チャンキング | 新しいラスターオブジェクトをチャンクとして保存するかどうかを指定します。 | Boolean | 元のラスターオブジェクトと同じです。 | なし。 |
chunkdim | 新しいラスタオブジェクトをチャンクとして格納するために使用されるディメンション。 | String | 元のラスターオブジェクトと同じです。 | このパラメーターは、chunking パラメーターがtrueに設定されている場合にのみ有効です。 |
chunktable | 新しいラスターオブジェクトを格納するために使用されるチャンクテーブルの名前。 | String | '' | '' またはNULLを指定した場合は, ランダムな名前の一時チャンクテーブルを生成してデータを格納します。 この一時チャンクテーブルは、現在のセッションでのみ有効です。 新しいラスタオブジェクトの永続チャンクテーブルを作成するには、チャンクテーブルの名前を指定する必要があります。 |
compression | ラスタオブジェクトの圧縮に使用される形式。 | String | 元のラスターオブジェクトと同じです。 | 有効な値:
|
品質 | 圧縮後の新しいラスターオブジェクトの画質。 | integer | 元のラスターオブジェクトと同じです。 | 有効な値: 1 ~ 99。 このパラメーターは、compressionパラメーターがJPEGに設定されている場合にのみ有効です。 |
interleaving | 新しいラスタオブジェクトのインターリーブタイプ。 | String | 元のラスターオブジェクトと同じです。 | 有効な値:
|
エンディアン | 新しいラスタオブジェクトのエンディアン形式。 | String | 元のラスターオブジェクトと同じです。 | 有効な値:
|
セルタイプ | 新しいラスタオブジェクトのピクセルタイプ。 | String | 元のラスターオブジェクトと同じです。 | 有効な値:
|
optionsパラメーターの値に含まれるパラメーターを次の表に示します。
パラメーター | 説明 | データ型 | デフォルト値 | 補足 |
パラレル | 許可されている並列処理の程度。 | integer | ganos.parallel.degree | 有効な値: 1 ~ 64。 |
ストレッチ | ピクセル値のストレッチに使用されるメソッド。 | String | none | 有効な値:
|
例:
指定したバンドを新しいラスターオブジェクトに変換します。
SELECT ST_SubRaster(rast, 1, '0-2 ', '{"chunktable":"chunk_table", "chunk_table":true}')
FROM raster_sub
WHERE id=1;
ピクセルタイプとストレッチピクセル値を並行して変換します。
SELECT ST_SubRaster(rast, 1, '0-2 ', '{"chunktable": "chunk_table", "chunking":true, "celltype": "8BUI"}', '{"stretch": "data_type", "parallel": 4}')
FROM raster_sub
WHERE id=1;