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

ApsaraDB RDS:ST_SetValue

最終更新日:Jan 15, 2024

このトピックでは、ST_SetValue関数について説明します。 この関数は、ジオメトリまたはラスターの行と列に基づいてピクセル値を変更します。

構文

ラスターST_SetValue(raster raster_obj、
                   整数行、
                   整数列、
                   ダブル値、
                   整数バンド);

ラスターST_SetValue (ラスターraster_obj、
         geometry geom,
                ダブル値、
            整数バンドのデフォルト0、
                 boolean rebuild_pyd default true、
            cstring setvalueOptions default ''); 

パラメーター

パラメーター説明
raster_obj指定されたラスタオブジェクト。
変更されるピクセル値の行番号。
変更されるピクセル値の列番号。
新しいピクセル値。
バンド変更されるピクセル値のバンド番号。
rebuild_pydピラミッドを再構築するかどうかを指定します。
setvalueOptionsピクセル値の変更オプション。 このパラメーターの値はJSON文字列です。 詳細については、「setvalueOptionsパラメーターのフィールド」をご参照ください。
表1. setvalueOptionsパラメーターのフィールド
フィールドデータ型デフォルト値説明
ウィンドウ_クリップboolfalseジオメトリーオブジェクトのバウンディングボックスを使用してラスターオブジェクトをクリップするかどうかを指定します。
  • true: ピクセル値を変更するための領域として、ジオメトリオブジェクトの最小境界矩形 (MBR) を使用します。
  • false: ピクセル値を変更する領域としてジオメトリオブジェクトを使用します。
rast_coordboolfalse入力ジオメトリがピクセル座標を使用するかどうかを指定します。
  • true: ピクセル座標が使用されます。 x座標は画素の列番号を指定し、y座標は画素の行番号を指定する。 x座標とy座標の有効な値は0から始まります。
  • false: ピクセル座標は使用されません。

select st_value(rast, 0,2, 1) from raster_table order by id;

update raster_table set rast=st_setvalue(rast, ST_geomfromtext('MULTIPOINT(0 0, 2, 10)', 4326),250.0, 0, true);

update raster_table set rast=st_setvalue(rast, ST_geomfromtext('LINESTRING(211 77, 233 100)', 4326)), 10.0, 0, false, '{"rast_coord":true}');