1 つ以上のソースラスターオブジェクトをターゲットラスターオブジェクトにマージします。
構文
raster ST_MosaicTo(raster raster_obj, raster source[]);パラメーター
| パラメーター | 説明 |
|---|---|
raster_obj | マージ先となるターゲットラスターオブジェクトです。 |
source | raster_obj にマージする 1 つ以上のソースラスターオブジェクトです。 |
注意事項
ST_MosaicTo を呼び出す前に、ソースおよびターゲットのラスターオブジェクトが以下のすべての要件を満たしていることを確認してください。
バンド数が同一であること：すべてのラスターオブジェクトは、同じバンド数を持つ必要があります。
ジオリファレンスの整合性：すべてのラスターオブジェクトがジオリファレンスされているか、またはいずれもジオリファレンスされていない必要があります。すべてがジオリファレンスされている場合、モザイク操作にはワールド座標（地理座標）が使用されます。
空間参照系が同一であること：ワールド座標が使用される場合、すべてのラスターオブジェクトは同じ空間参照系識別子（SRID）およびアフィンパラメーターを共有する必要があります。ピクセルタイプは異なっていてもかまいません。
NoData 動作の設定
ganos.raster.mosaic_must_same_nodata を設定することで、モザイク操作における複数のソースラスターオブジェクト間の NoData 値の扱いを制御できます。モザイク操作中、NoData 値は変更されません。
| 値 | 動作 |
|---|---|
true | すべてのソースラスターオブジェクトは、同じ NoData 値を持つ必要があります。 |
false | ソースラスターオブジェクトは異なる NoData 値を持つことができます。ただし、モザイク操作後にピクセルのセマンティクスが変化する可能性があります。 |
このパラメーターを設定するには、次のコマンドを実行します。
Set ganos.raster.mosaic_must_same_nodata = false;使用例
次の例では、id < 10 の条件を満たすすべてのラスターオブジェクトを、id = 11 のラスターオブジェクトにマージします。
Update raster_table Set raster_obj = ST_MosaicTo(raster_obj, Array(select raster_obj from raster_table where id < 10)) where id = 11;