適用対象:
Databricks SQL Databricks Runtime 17.1 以降" とマークされているチェック
Important
この機能は パブリック プレビュー段階です。
注
この機能は、Databricks SQL クラシック ウェアハウスでは使用できません。 Databricks SQL ウェアハウスの詳細については、 SQL ウェアハウスの種類に関するページを参照してください。
入力行文字列の GEOGRAPHY または GEOMETRY 値から n 番目のポイントを削除します。
Syntax
st_removepoint ( geoExpr, indexExpr )
Arguments
-
geoExpr: ラインストリングを表すGEOGRAPHYまたはGEOMETRY値。 -
indexExpr:削除するポイントのラインストリング内の 1 から始まる位置を示すINTEGER値。
Returns
GEOGRAPHYまたはGEOMETRY型の値。indexExpr番目の位置のポイントが削除された後のラインストリングを表します。
出力ラインストリングの SRID 値は、入力 GEOGRAPHY 値または GEOMETRY 値と同じです。
出力ライン文字列の次元は、入力 GEOGRAPHY または GEOMETRY 値と同じです。
いずれかの入力がNULLされている場合、関数はNULLを返します。
エラー条件
-
geoExprの値が linestring ではない場合、または空の linestring である場合、関数はST_INVALID_ARGUMENTを返します。INVALID_TYPE。 -
indexExprの値の絶対値が 0 またはラインストリング内のポイント数を超える場合、この関数はST_INVALID_ARGUMENT.INVALID_INDEX_VALUEを返します。
Examples
-- Returns the linestring after removing the second point counting from the left.
> SELECT st_astext(st_removepoint(st_geomfromtext('LINESTRING(1 2,3 4,5 6)'), 2));
LINESTRING(1 2,5 6)
-- Returns the linestring after removing the first point counting from the right.
> SELECT st_asewkt(st_removepoint(st_geogfromtext('LINESTRING(1 2,3 4,5 6)'), -1));
SRID=4326;LINESTRING(1 2,3 4)