すべてのプロダクト
Search
ドキュメントセンター

PolarDB:ST_SubRaster

最終更新日:Jun 21, 2024

このトピックでは、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元のラスターオブジェクトと同じです。 有効な値:
  • なし
  • JPEG
  • ZLIB
  • PNG
  • LZO
  • LZ4
品質圧縮後の新しいラスターオブジェクトの画質。 integer元のラスターオブジェクトと同じです。 有効な値: 1 ~ 99。

このパラメーターは、compressionパラメーターがJPEGに設定されている場合にのみ有効です。

interleaving新しいラスタオブジェクトのインターリーブタイプ。 String元のラスターオブジェクトと同じです。 有効な値:
  • bip : ピクセルでインターリーブされたバンド (BIP)
  • bil : ラインでインターリーブされたバンド (BIL)
  • bsq : バンドシーケンシャル (BSQ)
エンディアン新しいラスタオブジェクトのエンディアン形式。 String元のラスターオブジェクトと同じです。 有効な値:
  • NDR: 少しエンディアン
  • XDR: ビッグエンディアン
セルタイプ新しいラスタオブジェクトのピクセルタイプ。 String元のラスターオブジェクトと同じです。 有効な値:
  • 1bb: 1ビットブール
  • 2bui: 2ビット符号なし整数
  • 4bui: 4ビット符号なし整数
  • 8bsi: 8ビット符号付き整数
  • 8bui: 8ビット符号なし整数
  • 16bsi: 16ビット符号付き整数
  • 16bui: 16ビット符号なし整数
  • 32bsi: 32ビット符号付き整数
  • 32bui: 32ビット符号なし整数
  • 64bsi: 64ビット符号付き整数
  • 64bui: 64ビット符号なし整数
  • 32bf: 32ビット浮動数
  • 64bf: 64ビット浮動数

optionsパラメーターの値に含まれるパラメーターを次の表に示します。

パラメーター説明データ型デフォルト値補足
パラレル許可されている並列処理の程度。 integerganos.parallel.degree有効な値: 1 ~ 64。
ストレッチピクセル値のストレッチに使用されるメソッド。 Stringnone有効な値:
  • none: この関数はピクセル値をストレッチしません。 ピクセル値がピクセルタイプでサポートされている値の範囲を超えている場合、この関数はピクセル値を指定された極値に置き換えます。 この極値は、ピクセル値に応じて、最大値または最小値のいずれかとすることができる。
  • stats: この関数は、元のラスターの統計に基づいてピクセル値を拡張します。 元のラスターオブジェクトの統計を取得する必要があります。 この関数を呼び出す前に、ST_SummaryStats関数を使用して統計を取得できます。
  • data_type: この関数は、ピクセルタイプに指定された極値に基づいてピクセル値を拡張します。

例:

指定したバンドを新しいラスターオブジェクトに変換します。

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;